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Preface 





This is the firmware reference cnianijal for the Apple® TICS™ computer. It is for 
hardware designers and programmers who warn \o work with the 5y5;em firmware in 
lieu of using the Apple LIGS Toolbox routines to accomplish similar goals. 



About fhismanuaf 

Ai part of the Apple HGS technical suite oF manuals, the Apple //G5 firmware 

ficfet€nce covers the design and function of the firmware ihat drivers the Apple ITGS. It 
providas inforrriation aboul the entry points for the flrmT^'afe and describes the 
fimware functions and limitations, 

* S'c^e: None of the manuals in the technical suite stands alone. Other manuals Ln the 
siiite describe various tools to accomplish tasks that the firmware can aUci perfDrm. 
You shouSd become familiar wi;h the concents of the other Apple IICS manuals 
because for most applications, you may not xieed lo directly uk ihe firmware. 

The audience for this manual includes programmers who want to work with she 
firmware and application programmers who wish to convert or upgrade ejti^ting 
applications for the Apple II, U Plus, He, or lie to take advantage of the. new functions 
available on the Apple IIGS. 

^ Plote: Applications written explicitly for the Apple He can be booted on the 
Apple IlGS, widi no discernible difference in their operation. 

This manual does no! incorporate any descriptions of hardware; sec the AffylelTGS 
Hardware Reference for this informaiion. 
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What this manual contains 

Chapter 1, "Overview." provides an overview of the Apple IIGS nrmware. 

Chapter 2, "Nc^tes for Programmers," provides Informaiion for those who are already 

familiar with other Apple IE computers, 

Chapter 3, "Syitem Monitor Firmware," shqws how to use the system MoniUX to 
examine and change memo^ or register and to write and debug small machine- 
language programs. 

Chapter 4, "Video Finnware," describes the text input and output fadliiies of the 
Apple EGS. 

Chapter 5, "Serial-Port Firmware," describes the features ajid functions of Ihe built-in 
serial port. 

Chapter 6, "Disk II Suppon.,' describes the firmware suppon for ihe Apple Disk U® 
product. 

Chapter 7, "SmanPori Pirmwufe." defines and describes the SmartPon firmware as 
implemented on tiic Apple IIGS. 

Chapter 8^ "Interrupt- Handler Firmware," describes in detail the method by wtiich 
various kinds of internipLs are processed. 

Chapter 9, "Apple DeskTop iJus Micrtjcontroller^" describes the firmware portion of 

the Apple DeskTop I3us™, For a complete piaure of this subsystem, you need ihis 
manual, the Apple il<^s Hardware Ref^ence, and the Apple UCS Toolbox Reference. 

Chapter 10, "Mouse Firmware." describes the Apple IIGS mouse interface. 

Appendix A contajns a roadmap to the Apple IlCS technical manuals. Read this 
appendix lo determine which bwiks you need to Icajn more about a programming 
language, the Apple IICS hardwire, or some other aspect of the Apple HG& computer. 

Appendix B contains a list of the firmware ID bytes. 'I'he information le^5 you 
determine which machine in the Apple ll family is mnning your program. By 
examining these lU bytes, you can allow your program to take advantage of the features 
available on a particular member of this family, 

Appendix C describes the firmwire entry points fur ihe Apple IIGS, as well as the side 
effects of each routine, 

Appendix D describes the firmware veaors. By jumping to vectors instead of directly 
to particular firmware routines, you can maintain compatibility between your program 
and future releases of the Apple IIGS firmware 

Appendix E describes the soft switches that control various aspects of system 
behavior. These switch locations and contents are provided for reference only. The 
contents of the switches shouJd be modi lied only by system tools. 
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Appendix F lists the disasscmbier/mini-assembler opcodes. These will be useful lo the 
raad tine- language programmer \wtiQ uses ihs system Monitor to enter small program.? 

for quick le^Ls. 

Appendix C describes the Control Panel options and defaults. 
Appendix H describes the contents of memory banks SEO and SEl. 
A glossary follows the appendixes. 
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Chapter 1 



Overview 



This chapter gives a brief overview of The Apple ncs nimwart; and how it relates lo the 

rest of the s>'5iem siiftware, The Apple IIGS firmware is composed of various routines 
thai art stored in the system's read-only memory CROM). 'ITie Apple llGS Hrmwaire 
rouiines provide the means to adapt and canUral the Apple llGS system, 

Routines for the following Apple IlGS firmware are covered in this manual: 

; ,^>^.iL-m Monitor firmware 

c video firmware (I/O rcttiiincs) 

c serial-port firmware ffor character-at-a-Cime 1/03 

D Disk II support i^lot 6 supporO 

D SmairPort firmware (for block device I/O) 

D inlerrupl-handler finnware: 

D Apple DeskTop Bus CADB) microcuniroller 

D mouse firmware 



A word about other Apple llGS firmware 

Not all Apple ITGS firmware is discussed in this manual- The Apple TIGS ROM contains 
other firmware, important enough to warrant separate manuals; the Apple Uos 
"I'oolboK Cdesc-ribed in detail in the Api>ie ncs Tooibox Reference). Applesoft BASIC 
(described in the Applesojl BASIC Referenced, and the AppleTalk* Personal Network 
(described in Inside AppleTalid- 



Apple 1135 Toolbox 

The Apple IIGS Toolbox provides a means of easily constructing application programs 
without necessarily using the firmift'are routines described in this manual, programs 
that you construct using the looLs. wilt conform to Lho Apple Human Interface 
Guidslinss. By offering a common set of routines that every application can call lo 
implomeiit [he user interface, the tools not only ensure famiSiariiy and consistency for 
the user but also help to reduce the application's code size and development lime. 



Applesoft BASIC 

The Apple IIGS also has AppJesoft BASIC in ROM so thai you can create and run your 
own programs in BASIC, 
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AppleTalk 

Apple J'alk is a Incal-area nerwofk Lhai allows communicatinn snd resource sharing by 

up to 52 computers, disks, printers, modems, and oiher peripheral devices. 
AppleTaik consists of communicailon hardware and a set of comrnunicalion 
proiocDls. This hardware/software packase. together wiih ihe computers, cables and 
connectors, shared resource managers Cserveia}. and specialized application 
software, functions in three major configuraiions; as a fmall-are? inLerconnecung 
system, as a tributary to a larger net^'Ofk, and as a peripheral bus between Apple 
computers and their dedicated peripheral devices. 



Diagnostic routines 

The system diagnosdc routines arc manyfacturing test routines. No external entry 
pQiciK are defined For system diagnostic rdutines at this timi-. Thus, diagnostic 
fDUtincs ire not documeni-cd in this manual. 



The rofe of firmware in the Appf© f IGS system 

The firmware is that set of low-level routines that provides programme^ with an 
interface to the system hardware. The firmware, in turn, controls the display, the 
mouse, serial inpuL^cutput fl/O), 3nd disk drives. Firmware programs, sudi as the 
Monitor and the ConLnnl Panel, work directly with the system memory, 

Tradidonally, programmers have controlled hardware directly through their 
application program.^;, bypassing any .syslem rirmwaie. The disadvantage.' vf this 
approach is that the programmer has to do a lot more work. More important, 
b>'pa5SLng the firmware increases the likelihood that the resulting program will be 
mcompatible either with other programs or wi[h ftjture versions of the compruier. By 
using ihe firmware inierface, a programmer cs.r\ maintain compatiblliiy with current 
ar^d future releases of the iiysiem. 

For most of the Functions thM the firmwajT* enirj' points perffjrm, Ihere are equivalent 
rundions provided in the toolbox, The loolbos rouUnes, in iddition to performing 
like functions, also save and restore system registers when they are called. Read 

Chapter 2. "Notes for Programmers, ' for more details about system register usage. 



The role of fitrnware In tha Apple ]Igs system 



Levels of program operation 

You can ihink of the diJTereni llevels of program operation on the Apple TICS as a 

hierarchy, with a hardware layer ai ihe bouom, firmware layers in the middle, and the 
application at the top. Figure 1-] shows a hicj-aichy of" command levels-, in general, 
higher-level components call on lower-level ones. CThe levels a.re separated by lines; 
the hardware camponenls have heavy outlines,) 
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Levets of program operation 



Apple IIGS firmware 

The follow^ing sections provide an overview of the Apple IIGS firmware described in 

this mailual. 
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System MoniJor llrmwar© 

The system Monitor Qrmware is a set of routines that you can use to operate the 

computer at the machine-language level. You can cKamine and change memory 
locations, examine and change registers^ call system rtiuunes, and assemble and 
disassemble mach[ne-]anguage programs using the system Monitor firmware. 
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video firmware 

Video firmware allows you to manipulale the screen in low-resaJuiIon mode and text 
mode ihrougli your applicadon progfams and ftom the keyboard. Communication 
between the keyboard and fhe video screen is controlled by firmware subroytines, 
escipe codes, md control characEens. The video limiware provides on-soeen 
editing, keyboard input, oucpui to the screen, and cursor-control ficlliLies. 



Serial-port firnnware 

The Apple IICS sciiaUpon firmware provides a rncan^ to allow seriaJ crjmmunicadon 
with exicmai devices, such 35 printers and modems. TSit! serial-port Tirmwan; 
provides support for such options as hardware and software handshakina and 
bickground printing There are two serial ports, either of which can be conrigured as a 
prjjuer port or a modeim port. 



Disk II supF>ort 

The Apple LIG5 Disk II nrmware is a disk-support subsystem. It uses a built-in Intcgiaied 
Wo2 Machine OWTvI) chip and accommodates Disk II CDuoDisk* or UniDisk^) drives. 
Slot 6 is [he standard Disk 11 support sku- The iifmwflre ihaE communicaies with the 
IWM at boot Hme provides support for booting Disk Il-based software Other handling 
of Disk II devices is a function of whichever disk operating sysiem is booted. 



SmartPort firmware 

Disk n devices are directly manipulated by slot 6 control hardware. Inlelligent devices. 
by contrast, aie not directly manipulated by hardware, but rather aie controlled by 
safiwa re-driven command streams. Such devices arc labeled intelligeni iievices 
because ihey have their own contrdlers, which can inierpiet ihese command streams. 
The SmaitPor: firmware is a seE of Pk^sembly-Janguage routines (hat permit you to 
attach one or more mtelligenl devices to the external disk port of the Apple UGS 
system. Using the SmanPon firmware, yau can control these devices through 
SmartPoit calls, such as Open, Clase, Format. HeadBlock, and WriEcBlock. 
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[nteriupt-handler firmware 

Sysiem inierrupts haU lire execution of a program or the performaficc of a funciion or 
feature. The system -coniains buili-in iniernjpi-handJer firmware, a user's inLermpt- 
handlei" enuy poinl, and 3, means to noLiiy the user when an interrupt occurs. 



Apple DeskTop Bus microcontroller 

The Appile CJeskTop Bus CADli) mJcroconuollcr is used 10 receive information from 
peripheral uniLS attached (o Ihe Apple Desk'J'op Bus. The ADB microcontrnller polls 
the internal keyboard, sensing key-up and key-down ei'cnis as well as control keys, and 
optionaLy buffers Iteysliokes for later access by the 65CSt6. In addiiitm, :hc ADD 
rnicroconuoller acK as host for ADB peripheral devices, such as the detachable 
kcybtjard and mouse. The ADD microcontrDlkr has Els c-wn buiil-in set of 
instructions, including Talk,. Listen. SendReset, and Flush. 



Moii$0 Itrmware 

The Apple IIGS mouse firmware supplies the communication protocol for .siiinsijig die 
current status of the mouse. The mouse firmware uacks mouse-device position data 
and button status and provides, entry points for assembly- language control. 
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Notes for 

Programmers 
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This chapter contains [nformaTion thai will be useful to the eKperlenced 6502 
programmer as well as someone just beginning to use the Apple IIGS computer. 

The Apple IIGS has many new features not Tound in previous Apple computers 
Pfograms written for [he Apple Ik or the Apple lie vAll mn un die Apple IIGS, but do 

noi take advantage of these new featuiBS. 

Among the new features of the Apple Ilcis is a new set of registers, pseudoregtsters. and 

flags, collectively known as Ihc eaviroiuueat. Before you change the environment 

for the Apple IIGS system, read the following sections, which outline these new 
fearufes. 



Introduction to the Apple IIgs 

The Apple IIGS personal computer is a new Apple II with many high'perfoniiiaiice 

feamrcs- HighllghLs include 

D more powurful microprocessor with faster operation and larger memory 

high-rcsoIution RGB video for Super Hi-Kes colof graphics 

n multivoice diglia.1 sound synthesizer 

D detached kei^ard with Apple DeskTop Bus ccannector 

n built-in I/O: dcjck. disk port, and serial pons with AppleTalk interface 

□ compatible slots and game I/O connectors 

This list includes only the main features of the Apple IIGS. For a comprehensive list of 
features, rtfer lo the Technical Introduction to the Apple IICS. 



Microprocessor feotur^s 

Tlie microprocessor in ilu; Apple llGS is a 65CSI6, s. l6-bi[ design based on the 6502. 
Among die features of the 65Cai6 are 

n ability to emulate a 6502 B-bit microprocessor 

□ 16-bit accumulaior and index registers 

a 24-bit internal address bus for 16-megabytc memory space 
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Microprocessof mod^s 

The 65Cai6 microprocessor can operate in t:wo difTerent modes: native mode, with 
all of its new fcaiureSp and 6502 eoiulatlDa mode, for running programs written for 8- 

bdl Apple II computers. 

If you are uging emulation mode cxtensivety. you will be using the rirm-ware calls 
described in this maiiijaT. If you are using native mode, you probably will want lo use 
the equivalent tooiboK calls instead of directly calling the Tinnware. The toolbox calls 
save and restore the environmenl for yoit. 

Execution speeds 

The microprooessor in the Apple IIGS caji operate at either of two clock speeds; the 
standard Apple II speed cjf 1 MHz and the faster speed of 2.8 MHz. When running 
progj-ams in RAM, the Apple IlGS uses a Tew dock cycles for refreshing memory, 
making the efTeciive processing speed about 2.5 MHz. System rirmwarc. running in 
KOM, mns al [he full 2.8 MHz. 



Expanded memory 

Thanks lo the 24-bit addresses of the 65C8I6, the Apple liGS has a memory space 
lotaltng 16 megabytes. Of this toial, up to S megabytCH of memory are available fur 
RAM expansion, and 1 meaabyte is avalEabl^ for HOM expansion. For additional 
informaiion about memory, read the Technical IniroductUin la the Appte IlGS. 

The ininimiim memojy in the Apple lies is 256k. Programs written for the 

Apple IlGS — that ts, program.'s ihal run the 65CS16 microprocessor in native mode, 

thanoby gsEnifig. llio abilky lo AddtiL;.H riiuftj Jidji 120Tt ^t IIICLLIUI ]r -Lilli \ArtC U|_l LU SLHJUt 

176K of the 256k, The rest is reserved for displays and for use by ihe system firmware. 

The Apple IIGS also has a special card slot dedicated to [nemory expansion. All of the 
RAM nn a memory-expansion card is available for Apple litis application programs 
iliat call the Memory Manager, RKpansion memory is contiguous: Its address space 
cjEtends without a break Ihrough all of the HAM on the card Expansion RAM on the 
Apple IlGS 15 not limited to use as data storage; program code can mn in any part of 
RAM. 



Super Hi-Res disploy 

In addition to all the video display modes of the Apple He and Apple He, the 
Apple IIGS has two new Super I U-Res di.'spiay modes that look much dearer than 
standard Hi-Res and Double Hi Res. Super Hi-Res is also easier to program because it 
maps entire by:es onto the screen, instead of 7 bits., and its memory map is linear. 
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Used with an analog RGB video monitor, the new display modes produce high- 
quality, high-resoiuEion color graphics. Table 2-1 lists Lhe specincaiions of ihe two 
new graphics display mod^-j. 

Tobl« 2-T 

Super Hi- Res graphics modes 





R^iolutlon 


BHs por 
prxel 


Colon 

par l[n« 


Colon 
on acrBAn 




Moda 


Horn. 


V«rt. 


Colors 


3Z0 
640 


320 
640 


200 
200 


4 
2 


]6 
16" 


356 
256' 


4096 

4036 



' DirfefCnl pixcli in 640 mode use difFerent parts of the palette, 

♦ iVoM- Pixel is Ehoit for picture element. A pixel corresponds to ihe smalle.;! dot you 
Can dia'w ort the acretin. 

Each dot on ihe Super Hi-Kes screen corrtispDnds to a pixel. Each pixel has either a 
2-biL C640 moide} or a 4-bit G20 mode} value associated with it. The pixel values ^lect 
colors from programmable color tables called patettes. A praleite coasisLs of 16 
entries, and each entry is a 12-bir value specifying one of ^096 possible colors, 

In 320 mode, each pi»el consists of -1 bits, SO it can select any one of the l6 colors in a 

palette. In 640 mode, each byte hold? four 2-bit pixels. The l6 colors in ihe palette a.re 
divided into four groups o( A colors each, and successive pixels select from successive 
groups of 4 colors. Thus, even ihiough a given pixel in 640 mode can be one of Only 4 
colors, diiTerent pixels in a line can take on any of the 16 colors in a palette. 

To further increase the number of colors available on the display, there can be as 
many as l5 different palettes in use at the same lime, aliowing as many as 256 difTerent 

colors on iJne screen. 



Digital sound synthesizer 

In addition to the single-bit sound output found in other compuiers in the Apple n 

family, the Apple IIGS has a new digital samptin^ sound system buill .around a spedal- 

purpo^e synlheiizer IC called the Digital Oscillator chip, or DOC fur shdrL Using 

the DOC, the Apple IIGS can produce l5-voiee music and other complex sounds 
without tying up its nnain processor. Refer lo the Apple UGS Hardware Reference for 
details about the sound system and the DOC. 



Detached keyboard with Apple DeslcTop Bus 

The new detached keyboard includes cursor keys and a numeric keypad. The Apple 
DeskTop Bus, which .supports the keyixjard and iha Apple mouse, can also handle 
other input devices such as joysticks and graphics tablets. 
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Built-in I/O 

like the Apple flc, ihe Apple lies has two built-in disk pons and two serial I/O pons. 
Prpgrams can use Lhe bniU-in ports afid peripheral cards in sloLs. The buIU-in 
ApplcTalk interface uses one of lhe serial potts, 

The Apple lies also has a buUL-in cltKk-calendar with a baiiery for coniinuous 

operalion. 



CompaHbfe sfots and game I/O connectors 

Ifi addiLion to tlac mt:r¥iior>^-expansion ylgi, Lhe Apple lies has seven I/O expansion 
slols like Eh&5e on Lhe Apple ITe. Most peripheral cards designed for die Apple 11 Plus 
and [he Apple He will work in il\c Apple IlCS slots. The Apple IIGS also has game I/O 
conjieciors for existing game hardware. 



Environment for the firmware routines 

Many useful subrautines are listed in Appendix C, Timiwatc Entry Points in Bank 
SOO." All of ihese routints have one diing in common: To use ihem, lhe processor 
must be set up tc3 took and act exacUy like a 6502 in all respects. You musi therefore set 
the t}pera[ing environment lo cause this irans formation lo happen. 



Impaitorl 

"Ihte section contains the specific details about setting and restoring Tfie 
envJfGnment before calling and after letumlng from calltng ttie drmwore roLrtlr^es, 
Vou must follow these requirements sxcctlv. or youir prograrri will roll. 



th(^ specific operating environment requirements for all these routines are as follows: 

a d bit = Cdedmal-modc biO 

a e bit = 1 (emulation- mode biO 

D D register - SOOOO (direct-page register) 

:i DBH register = $00 Cdaia bank regisier, called B in Chapter 3) 

□ PBH register = 500 (program bank register, called K in Chapter 3) 

n 5 register = SOIxx (stack poinierj 

* !\'ote; U you make tools calls instead of usijig the firmware direcUy, you will not have 
[O worry about the operating environment. The tool calls handJe the environment 
for you, 



Environment for ttie rrmwara rotjtln&s 
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Setting up the system 

To coTtcoly prepare the syslem for calling the nrmware rDu Lines, you must Lake several 

G Save your environmenE. 

D Gel into bank $Q0; JSL Cjump to subroutine long) to a rcjutine in bank SOO. 

n Set Lhe D register to 50000. 

n Set Lhe dbr lo SOO. 

D Save the value of the native-mode slack poinier, and sel the stack pointer La the 
value of the emulaiiori'mode Slack potnier, 

u Select emukiion niode: set Ibe e bit lo 1. 

These steps make the 65C&16 appear Lo be a 6502 micraprocessor operating in jts 
notTOfll enviioninent- Now you can set up the machine registers with the parameters as 
required by the particuiar firmware routine and execute a J5R. (jump lo subrouiine), 
These steps are explained in the sections Lhai follow. 

Save your eRviJorwneni 

The environmeni is ihe complete set of machine registers and flags that your progfam 
uses, Besides machine registers, the environment includes such things as processor 
speed, read-only memory (ROM) bank, languagi^-card bank, and random-access 
memory (RAM) shadowing 

When you run the various firmware routines, ilie system will use the machine registers 

for iLs own purposes. If you depend on a particular register having a specific value 
when you finally return to your own code, then save that regisier's conients on your 
niEtive-modc suck or wherever else you wish so that you can restore the rcgi.sier's 
tomenis before you relurn to your other program code. To delermlne which registers 
each firm-n.-are routine uses or aiTccts, see Appendix C, "Firmware Entry Points in Bank 
SOO.- 

GeUntobH^nkJOO 

!f you aitempt Lo mn Lhe 65C816 in emulation mode in any bank other than bank $00, 
no interrupt processing can lake place. You enter program bank SOO by executing a JSL 
(jump to subroutine long) to someplace in bank SOO (if you are not already there), 
where the next steps are performed. Thi^ JSL sets lhe program bank register 00 to SOO, 
fuindirg that pajl of Lhe firmware routine rcquiremeni. If you did not save your 
cnvLronment beifore entering bank SOO, now would ha an equally good lime Lo do so. 

S^ the D r^isler to $0000 

A 6503 expects its zero page (called the direct page for the 65Cei6 when opetaiing in 
native mode) to exLin in [he microprocessor address range of SOO lo 5FF, VC'lien lhe D 
register Is seL to 0, the zero page gets posits oned correctly for a 6302. 
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SeltheDBRto^DO 

The DBR is the upper 8 bfis of the 24-bit data address. The DBR must have 3 value of 

$00 for ^e firmware routines to fijnction. 



Save the value of the nativ©-mode stack point©* 

When you switch 10 emulation mode, the upper S bils of your stack pointer will be lost 
thus, tJiis value must be saved somewhere so that it can be restored to its original value 
ofi exit from this roudne. 'Ilie most coinmon technique is lo save the v^ue of die 
entire naLive-mode stack pointer on the emula lion-mode stack. 

* ^ote: The main and auxiliary stack-page switches cannot be used in native mode. 
Thus, when swiiching to emulation mode, you must i^e the rnain slack. 

Tlie routine ttiat follows saves the native-mode stack pointer and correctly sets the 

values for the direct-page register and the data bank register. IF your program requires 
other values for ihe direct-page arid data bank registers, save ihese environment 
variables (as well as other register values in your environment)' so that you can j^eslore 
M values after returning from the Tirmware routine that you call, The El^ULSTACK 
routine can be appended to the bcgiiiiniri,g of your own firmwartj calling sequence, A 
cDrrespcnding routine to restore [he native-mode stack poinler is given in. the section 
'Setuj-ning to Native Mode' later in thiii chapter, 

^-Before entry, SflVB VOUB emriranment ! 

; Emulation stacX; pointec is saved here 

; 1-S-bit m and k 

;Teirporary save of native-mode staeSs painter 

;e-bit jfi 

,'Cet stack pointer page 

I Is Stsclt al3'e,gdy in pd'^g' 1 ? 

;If ao, don't iget emulation stack pointet 

I'Set stac^ page to SOI 

.■Get emulation acack pointer 
,'Set emulation Btack poiriter 
;Save natlve-mc^ atack pointer 
jEm-jiation mode 
; Set emulatloji mode 

;Set direct -paga register to S&OOO 



;3et cata barft rflgiater to $[30 

J Here cojiLini^e with YQUR tpcocQEsing 



EMtliSTACK 


EQtl 


SOIOIOB 


TQEHL3L 


REP 
TSC 
TAX 


tS30 




SEP 


¥520 




XSA 






DEC 


A 




BEQ 


ALPEAD¥?G 




LDA 


tfOl 




KBA 






LDA 


SHULSTAGK 




TCS 




AUlEMYPCa 


PHX 

SEC 
XCE 






PEA 


SDDOO 




PLD 






■LDA 


#0 




PHft 






PLB 





Environment fof th& flrmwafe routines 



13 



Select emulation mod© 

Selling the e bit to 1 puts ^e 65C816 into emulaiian mode and auLomaticaUy sets ihe m 
and X pracessor siacu* bits lo 1. The x bit forces the X and Y regtscers lo be treated as 
only S bits wide. The m bit Forces the acoimuEator lo be ircated as only a bits wide. 
This step also affects the sb^e of the stack and tiie contents of the slack reHister. 
Speofically, the value of the upper 8 bits of Lhe slack poinier is forcKtl to a value of 
hexadecimal SOl (the same as the 6503), WTiile you arc in cmijlatjon mode, these 
upper a biEs never change. Thus, lhe sii;e of the stack is restricted lo 256 bytes. 

Now you can set up the machine register? as required by the particular firmware routine 
and JSH. 



Returning \q native mode 

To return to native mode, ycHj mu5i [Xrform a set of steps complemeniary to the 
preceding steps that caused your program to enter emulation mode in the firal place: 

n Kestoffi the native-mode stack pointer. 

D Restore your environnient (if you are within the bank $00 entry routine). 

Then you can execute an RTL Creturn from subroutine long) to your paint of origin 
Ca:suming [hat you performed a JSL lo enter this code in the first place]). These two 
return steps are e>:plained in detail in the next two sections. 



Restoie th« native -modd staek pointer 

Return Lo native mode. The rolluwLng tixample is the complement to the preceding 
example that saved the native-mode slack pointer. Notice that this njuiine afsu reiurns 
Lhe processor lo native mode Oi seis the e bit to and then sets the m and x bits to 0). 



PRP 

CLC 

PLP 
REP 
PLX 

TXS 



i$30 



;Pj:e5erve firtTivJate's c [cittyl S^LALliS 

fSat native mode 

;If s stLll ifl fl-bit; 

; Restore the carry flag 

;Set 16-bit 

iGet riAtilve stack pointer fro-m SDLulatlO'ri stack 

r'Set the rtative-mode staclt pointer 

; How teatare the rest of your env iraisnserLt '. 



Restore your environment 

Kestore all of your registers and flags to the values that your program expects to find on 
return. 

Assuming ihat you used a J5I. in the code that saved your environment and your native- 
mode stack pointer, you can now perform an RTL and resume execuUan uS your 
program. 
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other requirements for emulalion-mode coc£e 

The preceding example showed how to caJl firmwatc rouLincs and spedfitdl that the 
processor iiiLL^t Ise in emulaiion mode, running in bank SQO, to call the firmware 
routines. ITiere may be other times when you wsni to use ernulalion mode From bankiS 
Dtheir [han bank SOQ, but you must observe other specific fequiicments. 

When you run emulaUon-mode code in a bank other than banik SOO, intenupis musl be 
disabled. 

<• Note.- For AppleTalls applications, you musl be sure that interrupts arc enabled for 
2:1 least 20 milliseconds out of every 1,1 seconds. For applications using the tick 
dounier, inlemapt£ must not be disabled for longer ihan 16.67 milliseconds or licks 

will be losL 

■^en you ai^s in a bank oLher ihan bank 500 with interrupts disabled, if you mix 6502 
and il55C3l6 instructions,, ihe 65C8l6 instructiorLS will slit fiimcLion a.s documenied- Bui 
note that all 6502-eqmvalcnt iiiisUTJciions behave Ihe same as a 6^02 regarding direcc- 
page and stack-page wrapping. The new 65CB16 EnstruciiDoa manipulate [he stack and 
direct page, bur do not wrap on a page boundary. "ITius, you must exercise care when 
using ihese new stack- or direct-page instmcUons. 



Cautions about chonging the environment 

If you write your own subroutines Cor programs^ that change some part of (he opieratEng 
environment, be sure that your code, ai exit, puw things back ihe way it found them at 
eriuy, This is especially ime of stack- and 7ero-page changes, data-bank-regL°Jter 
changes, m. c, and x changes, speed-register cl^angca, ROM-bank changes, and 
laiiEu age-card changes. 

Slack ond direct page 

for Apple II programs, Che stack and tfie direct page (called ihe zeropage for a 6502) 
musl be in iheir prupei" 6502 locatioris and the slack musi be 256 byies long, For 
Apple IIOS programs, slack size and stack- and direct-page locations are at the 
disaetion or the application. CGall Ihc Memory Mr.nager lo obtain a new zero-page 
area). 

'^lien you are in native mode, you can locate the stack anywhere withiii bank SOQ. If the 
stack i^j located- in memory at other than page 1 and the processor is switched to 
emuliLion mode, the upper half of the stack pointer will be tost (set lo SOt)- When the 
prDcessor is switched back lo native mode, the upper half of ihe slack pointer will 
remain set to pagt $01- To avoid losing the naiive^mode stack pointer when switching 
to emulation mode, you must lemporarJy save the stack pointer so it can be rcston^d. 
Sample t(3de for saving and nesloring the native-mode slack value is shown in the 
examples. 



Envlronmsnt for the flrmwore rouHri'^s 
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Dota Ixink registers ond e, m, and k flags 

If your subroutine changes ±e conienia of the data bank rcgisicr or ihe c, m, and x 
flags, you should resiore them to their origina] values. These registers affect not only 
ihe locaijons to which the index registers X and Y poini and thi; length of ihe A, X, and 
Y registers; the contents of these regisiecs a3so alTea how the ptoccssor interprets iis 
insimclions. Otie cgh easily imagine an tncoffccE flag or register value causing a 
perfectly good program to fail. 

Speed" and £hadow-teoislor chonges 

Changing any of the bits in the Speed or Shadow register (see Chapter 3, "System 

Monitor Firmware''^ also affects ho* the system runs, (The Shadow- register bits of 
intqrest and the Speed-change bit are aSI accessible through iht pseudorggistgr called 
Quagmire. For assembly! a nguage programming, yoy access these registers directly. 
See ihe AppJe IJGS Hardware Reference for more information.) 

Language-CQid chorines 

If you change the active ba.nk of the language card without restoring it on exit from your 
code, yoii again risk ruining another programmer'.s cude. For example, the other 
progranuncT mighi have executed a JSR or JSL out of some code in a ROM. bank or a 
particulaj bank of ihc languagt: card, llhe rerurn address of ihat routine is on the stack 
and poinL5 to the rerurn address within dial same bank of ROM or the language card. If 
your routine changes banks without restoring them to the original values upon exii, the 
sysiem wilt fail. 



General information 

This section contains other general mformalion useful in creating 65C816 programs 
for the Apple llGS. 



Apple llQS Interrupts 

"I'he Apple llGS firmware provides improved interrupt support, vt^iy much tike the 
enhanced Apple lie interrupi support. Neither machine disables interrupts for 
exiended periods. 

'ITie main purpose of the iniGrmpi handler is to support inlcrnjpis in atiy memory 
configuralion. ITiis is done by saving the machine's .state at the time of the inieriupt, 
placing the Apple HGS in a standard memory configiiraliDn before calling your 
program's tnternjpt handler, and then restoring (he original state when your 
program's interrupt handler is finished. (Sec Chapter 8, "rnternjpt-Handler 
Firmware," for more inforrn3[Jon.) 
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Boot/scan sequence 

The booi/scan sequence is iniiiated by sf^leaing Staftnp: Scan from the Control Panel 
Slots menu. When the selection is made, the Apple IIGS starts at ska 7 and tests each 
siot for a bcK>t device; ihe first device found is booted. The Apple DGS 5tan.s its scan at 
Uie slot selected, ignoring all ^lois with a. higlier number, and wqtH down to slot 1, If 
no boot devices are in the slots, ihe screen disptays ihe message shown in Figure M 
(the apple moves back and forth across the screen). 



Cneck Startup D&vlce 



Flgur« 2-1 

&oot-fQllure screen 

If slot 7 is enabled for an external device, tlic scan will proceed as jusi: described. 
However, if slot 7 is sei lo AppleTalk and if the stuiup slot is set la slot 7, the fifinwarc 
will try lo boot ApplcTalk. If RAiM Disk or ROM Disk is selected, the SmaitPort 
firniware will t^e activated and ihe system wiJ atlempt to boot from [he RAM disk or 
KOM disk Csee Chapter 7, 'SmartPort Firmware"). 



Program bonk register 

The 65616 program bank register wraps within a 64K bank boundary. Data retrieval and 
storage, however, do not wrap within a 64K bank. This means that a program Oial 
executes at the top of a l>aiik continues lo ewecute at the bottom of the same bank, even 
between opcode ^nd c^ran^ within a single instruction. Further, data retrieval and 
aorage at the lop of a bank simply roEl ov'er into the bottom of the next bank and 
continue as if no bank had t>een crossed. TTiis sarrte opeialion also occurs with 
indexed instructions. 



Importanf 

You nriLBt exercise core when writing code fhat deals directly wffri state- 
depencfent harcfwore. The cycle-bv-cycle operotlons of fhe fi5C8l& emulotlon 
mods arxJ tti& 65C616 nath/e mode differ. This behavior has to do with indexed 
Instructions. In. one rrwd©. q false read occurs at a glv&n cycle, and In the ott>er 
mode, a false write occurs. This difference can cause pioblems If soft switches end 
hardware expect one opera tlort ond get another. 



General Information 



17 



Exchanging the B and A registers, X6A 

The A register Ccalled the C register in nalive mode) is a l^^bii register used in both 
tiative and emulation modes. In native mode, all 16 bits are used,, in emulation mode 
a bits are u^ed for ihe A register and 8 bits are used Tor liie B register Csee Figure 2-2). 

C (A> Native mode 



Ml I ITTTl 



EmuJatlon mode 

Figure 2-2 

Accumulotof for emulation and txj^vs modes 

Some prDgrammtirs wiih 6502 experience might sec the XB,\ instruction as a quick way 
CO save (he current contents of the A register while mnning in emuSation mode. Then 
they mighi afffiume that it Is sppropnate to jump to sysKm routines Clhal have to be 
executed Trom emulation mode anyway) and return, restoring the A register from B by 
another XBA. liowever, the contents of the B register (the old fi^bit accumulator 
value) will not be valid on return from any firmware routine, Tlius, do not transfer 
control to any system code prior to restoring the A register with the following XBA. If 
you do, it is at your own risk. Although current dfioimeniatiDn For ihe Urmware entry 
points occasionally may show that the concents of the B rcgi^ief are preserved, Ihis will 
not necessarily hold uue for later releases of the firmware. 

For example, the following code works in 8-bit mode; 



X3A 


;Preserve ft 


LDft FLAG 


;Dn something with A 


LSR 


;MDve LSH ta carry 


XBA 


; Seat ore A 


The following 


code does not work: 


XBA 


^Preserve A 


LDA <TA 




JSR C0U1 


iConcrol ia traneleered 


XBA 


;KostOre A 



The A in ths first line is not the sanie as the a iJi the fourth line. 
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This chapter escribes the Apple IIGS system Monitor firmware, a low -level, 
command-driven program that lets you examine the machine state as well as create 
and test small machine language progranns. A professional developer will likely use a 
sophisticated assembler and debugger in addition to the system ftJoniior Firmware. 

Note that when you use the Monitor to write machine- language programs, you can ase 
[he Monitor entry points listed in Appendix C, "Firmware Enlry Points in Bank SOO," 
to mike ^-Qur fob easier. Alio, if you uM the disassembler, you will be interested in the 
table of disassembler opcodes in Appendix F, ■Disassembler/Mini -Assembler 
Opcodes." 

The .^'stem Monitor firmware is a program that you can use to create and test your own 
machine-language programs for the Apple IlGS. From the Monitor, you can create 
programs that utilize various system-resideni subroutines Ca summary or which is 
contained in Appendix C, ■FirmT^'are Entry Points In Bank 500"! 'When you create 
your owTii programs or use the Monitor to examine programs that others have created, 
vaiious features of the .Monitor firmware assfSt you in your task. 

Hie Apple IIGS Monitor provides commands that 

D roanipulate memory by examining it; by entering changes in either ASCII or 

hexadecimal form; by moving, comparing, or tilling blocks of memory; and by 
searching for specified patterns 

a view and change the execution environment (microprocessor registers and Hags) 

c execute programs from the Monitor 

n step through and trace program execution (hooks orily; no code tn current ROM) 

□ pterform miscellaneous tasks such as seaing the display lo inverse or normal videOj 
displaying or setting the time and date, redirecting input and output, performing 
hexadecimal arithmcUc, returning to BASIC via cold or warm start 

□ invoke the mini -assembler 

D invoke the disassembler 



Invoking the Monitor 

The system Monitor resides in read-only memory C^^OM) beginning at location 
5FF69, or -151. To invoke die Monitor, you issue a CaL statement to this location from 
the keyboard or from a BASIC program. "WTien the Monitor is running, its prompt 
character (*] 'appears on the left side of the display screen, followed by a cursor. To 
use the Monitor, type 

Cflli -lil Return 

The prompt character and the cursor fa flashing blank space) appear: 
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Monitor command syntax 

You enier all iMonitor instructions in the same formal; Type a line on (he keyboard 
and press He[:urn. The Moniior accepts the Sine using Lhe I/O subroutine GETLK. A 
Monitor instfucUon can be up to 255 characters, followed by a carriage return, 
CGETLN is described in Chapter 4^ "Video Firmwire.'O 

A Moniior command car^ include four kinds of information: memory-bank number, 
addresses, data values, and command characieTs. You type addresses, memory-bank 
liumbers, and data values in ticxadeclmal notaUOrt, 

Tlte microprocessor in Apple TT computers prior to the Apple IIGS could addreaa 
memory only in an address range from to 65,535. The Apple Has. on the other 
hiand, can address up to 256 banks of 65,536 memory locations eadi. Thus, there is a 
need for a memory-bank ^ddre^s qualifier for the Monitor commands. You will see 
iKe complete address represcnied as ( bank/ aiii^ress) , where bank is to be specified 
as two hexadecimal digtis and address as four hcxadedimaj digits. 

When the command you type calls for an address, the Moniior accepts any group of 
hexadecimal digits, automatically providing leading zeros to fill out the width of the 
field of digits. 



Monitor commond types 

There are two distinct types of Monitor commands: commands that perform an 
operation (such as examining or filling memory) and commands Lhai change a 

register value. 

Tor commands dial perform an operaUon, each command you type coa'iiSB of one 
oommand character, usually the ^r^[ letter ofthe command name. Vt'hen die 
command is a letter, it can be either uppercase or lowercase. Ttie Monitor recognises 
46 djffereni cominands. Sorrte of Lhem are punctuation marks, some are letters, and 
some are control characters. 

* ^'ote: Although the Monitor recogntKes and interprets control characters lyped on 
an input line, control characters do npi appear on Lhe screen. 

For commands that afTect the contents of a register, each command you type consists 
of 1 value and a register name. For register names, the Apple IIGS Monitor does 
require diat the register name be entered using the proper case Cupperca^e or 
lowercase). The syntax of a register-modifying command is 

I value} = 1 rsgisteri 



MoTiitor command types 
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when you use 3. regisier-display command, the ippropriate case for you to use to 
modify the fcgister contents is shown in the display for esch register. Be certain to 
note whether the register naine is uppercase or lowercise and to use ihe ptjrreci case 
when selUng a register value. 

Tsble 3-1 lists the MoniEor commands and their synLajx ^oupetL by typo In Table 3-1 
and in ihc rest of this chapter, ihe command formats nfien. s^pedfy addresses from 
which data is obiained or lo which data is sent The source and target addresses take 

the form 

bank/ aeidrva 

where bank is an optional bank number Cone or two hexadecimal djgiLs) and aditfSSS 
is the address (one to four hexadecimal digits). The bank number, if present, is 
separaled from the address by a forward slash </) character. To make the command 
formats more understandable, several terms arc introduced here, each of which may 
be used tn lieu of bankf (^dress. Note that each of these tctm^ uses exactly the same 
formal: an optional bank number and the address. Tlie purpose of these substitute 
rDrms is to make the command fonnati (cspcdally within tables) easier to understand 
at a quick glance, 

"ITie follo'fting terms may be used 



fram_address 
io_address 

start address 



val64 
vaUO 

mm_l dd/yy 
hh'.mmtss 



An address fwiih opiionaJ bank) that serves as a data destination 

An address (with optional bank) at one end of a range of add "esses 

An addcess (with optional bank) at the oiher end of a range of 

addresses 

An address (with optional bank) at which the Monitor wiU start an 

operation 

An 8-bit (l-bylc) value specified as iwo hcKadecimal digits 

A l6-bit C2-byte!) value specified as four hexadecimal dig.it5 

A value expressed iS up to eight hexadecimal digits 

A value expressed as decimal digits 

Three 6-bit values separaied by forward slashes 

Three 8-bit values separated by colons 
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^^pnlTor commands gfouped by fype 
Cofnmantf fyp* 



Commortd formert 



ViBwfng and modifying m«mory 

Disptay sifigle memory location 
Display multiple memory locations 
Terminate memory-range display 
Modiiy consecutive memory 

Move daja in memory 

VeriJiy memory conients 

Fii] niEiTiciry (.zap) 

Pariem search tspedfied in four 

v,%Y^\ any or alf forms may be 

combined in a single search 

request) 

VIswing and modifying recflslen 

Examine registers 

Moclify accumuliiDr 

Modifjr X register 

Modiiy Y register 

Modily D regisier 

Modify DBR register Cbank) 

Modify program bank register 

Modify Btadi pomcer 

Mbdijy processor staims 

Modify machine-state register 

Modify Q\iagmire register 

.Modify l6/3-bit accumulator mode 

Modify 16/S'bit index mode 

In . . J E r. 

Modify native/emulaiion mode 
Modify language-card bank 
Modify ASCII filter mask 



i/rom address] 

i/rom_aiiitress} . [ to^addTEss) 
Control-X 

{ destination] t i vai\ { val\ \ '•Uteml ASCIP' ] 

I 'Jl^pASar I {va!) 

[ destination 1 < {/mm address } . [ to_adaress ) M 

{ desrinaiion] < {from_address\ . { lo_addres$}\ 

\vat\< \from_addr^5s) . {to_adftTes5\Z 

\ { vai]\<ifrQm_address) . | to_addms}¥ 

\ \ ' I23t* ? \< lfrQm_adaress] . [ to address] P 

V [ "liiera! ASai^ \\< i/rom_addre^s} . [ to address] P 

\ { Viill6]\<{fmm_address) , [to_addT0ss]? 

Control'E 

[vall6\^A 

{PStJ6]^K 
ivaf}6]^Y 

{valS6]^D 
{ ml] =B 
lvai\=K 
[ vaim =S 

{VdJ]-Q 

iv£il]^m 

(ffl/l-e 
( vai] -L 
{ val) •=? 



[contrnuedj 
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Tabl»3-I (contlnueci) 

Monitor commands grouped by fyP® 



CDmmand Pypi 



Command format 



Mlscellaneoui 






Begin inverse video 


I 




Begin normal video 


N 




Changt: Liitic and date 


^T^mm/dd/yy hhx mm 


ts$ 


Display lime and date 


-T 




Redirect inpui links 


( jto£}Control-K 




Redirect output links 


t,f^onConirol-P 




Change screen display lo text 


Contfol-T 




Change cursor 


Con:ro!-'^ I new_cunor_ 


cfiaracleri 


Convert decimal to hexadecimal 


~{vall6} 




Convert hexadecimal to decimal 


lyfl/e-ll" 




Perform hexadecimal maLh 






Add 


\val64\ + \vat64] 




Subtract 


\VQi6^]''{val^'i\ 




Multiply 


\val64)*\val64] 




Divide 


{ual64]_{vat64\ 




Jump lo cold-slart BASIC 


Conlrtjl-B 




Jump lo warm-5[art BASIC 


Controt'C 




Jump to user vecloi 


Control-Y 




Quit Monitor 


Q 




Program 9X9CUllon ond debugging 






Go (begin) program in bank SOO 


[start _address}G 




Execute from, any memory bank 


[start _address]x 




Restore registers and flags 


Control-R 




Resume ejcecuUon 


lstart^a{iaress]R 




Perrofjn a. prograin step 


[start _addrsss}S 




Perform a program trace 


{5lart_address]'T 




Disassemble Oisi) 


[start _addres^l. 
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Monitor memory commands 

rhe MoiiiLiir rommands dial directly affcci nnemory arc discussed in this section, 
These include commands to examine and change rncmory locations, search fof 
specific eombinatiofis of memory contenis. change mcmciry content; individually or 
in blocks, and compare itiemnr>' h[ocks. The Mpniior prt;senL>i memory dumps in 
both ASCII and hejcadectmal fnrmacs. You can use eilher notation lo enter your 
requests for changes U3 memory. 

Wl:cti yqc use ihe Motiiior to examine and change the cnments of memory, the 
MnniioT kecf^s track of the address of the last Irx-ation who^ value you inquired about 
(calJed the last-opened location) and ihe address nf the locadon that h to have iLs 
value changed next fcallc^d [he next-changeable location) In addition, once you 
have specified a bank number in nne of your ia-^injctions, ilio Moniior continuEs to use 
that bank number witJi at] other insirucuons until you expliciity change it. 

fn Ihe paragraphs thai follow, the memory-contents displays sre based on whai you 
would see if you were using the tiisplay In SO-column mode. Mt^en in 40-ca]umn 
mode, the Apple IIGS Monitor dumps memory 8 bytes per line When in 80-column 
mode, the Apple litis Monitor dumps memory 16 bytes per line. 

Table 3-2 lists the Monitor memory commands. 

fabls3-2 

Commands for viewing ond modifying memorv 

Ccmma/gd tvp« 



Command foimigt 



Display single memory Incaiion 
Display mulltple memory locations 
Temitnate memory- range display 
Modify consecutive memory 

Mtn^e data in memory 

Verlfj.' memory contents 

Fill memory {zap) 

Paltecn search (specified in four 

ways; any or jEl forms may be 

combined in a single search 

request) 



{frDm_addreiS\ . \ loatfdrsss] 

Comrol-X 

\ desliTtadon] : ! t/ai] < val] ( "liieral ASCfr ) 

t 'JlipASar ] [val] 

[ deslinattoti ) < l/rum^address] . { lo_aiidress]M 

[destiJMtion]<[/rom_addtms\ , i io_addreisl'V 

I val] < {/roin_address \ , [ ioaddrsss ) Z 

\ [vai\\<[froin_address\ . I to^address}? 

\[' 123t' \\< i/rom_addressl . [ lo address]? 

\ {^literal ASaT" ] \<\from_adaT^ss\ . > to_adaress\P 

\ {vail5\\<ifn}m_address] . | to aadrgss}P 
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Examining memory 

The syntix required [o display a single memory localion is. 
>| ^Tijfe/ address \ Return 

If iJie MoniLor is already examining the bank desired, you don't have to include the 
bank number in Lhe insuuction. Simply lypc the address and press Return. However, if 
you're not sure which bank Ibe Monitor is in, include ihe bank number 35 shown In the 
example. The Monitor responds with the bank and address you t^ped 
ibank/aUUre-ss), a colon, and the hexadecimal contents of ilic location. For 
example, to examine memory location hexadectmal SlOOO, next to ihe Monitor 
prompt (') type 

'OO/ICOO Return 

The bank and address arc displayed as well as the contents of address SlOOO: 
oa/iaoDizc- 

^ Note: Dollar signs tS) preceding addresses that appear in runiiing text signify ihai 
the addresses are in hexadecimal noiaiion; hov^'ever, dollar aigns are ignored by 
the Monitor and must be nmiued when typing insinjc-iiona. If location SlOOO had 
contained ASCII code, the ASCII equivalent would be displayed on ihe far right of 
ihe screen, as the foU awing examplt; shows: 

'looo Ftecura 

WoLioe thai the bank address *as not entered because you know thai you are in bank 
SCJO) The result i^ 

■'> Note: ASCII codes are decoded in the rightmost S spaces of your displ^V- Printable 
ASCII characters are displayed as normal characters; nonprintable characlen5 are 
diSpla^'ed sa periods (.). if you are using the Moniior in SO-column mode, the 
ASCII characters will lake up ihc rightmcisi 16 spaces instead of 8, and 16 sets of 
hexadecimal dcgii pairs corresponding t:D Lhe byte valuer stored in the displayed 
memory range. 

\Hien you change Lhe contents t)f memory, the Monitor saves the address of the last 
location in which you ciiangcd the contents and the address of the next location to be 
changed— in other words, the lasi-opened location and the next-changeable 
location. 
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Examining consecutive memory locations 

You may want to examine a block of memory Joc&tiona, such as from 51000 to $1007. 
Simply type ihe starting address, a period, and the ending address and ilien press 

'lODO.ithO"? Return 

The contents of the memory loatlons are displayed as follows; 

50/1000:91 'JZ ^3 AH 45 55 DO 00 -ABCDEU,, 

Ifyau type a period (J followed by an address and ihen prea Retuin, ihe Monitor 
displays a memory dump: die data values siored at all the memory locitions from the 
one following the lasl-opencd kxation to the Icxatton whose address you typed 
foHowing the period. The Monitor saves the last location displayed as both the last- 
opened locaiion and dit next-changeable location. In these examples, the amount of 
data diiiplayed by the Monitor depends oti the diiTcrence between die address of the 
last opened location and the address after the perio<3. 

D0/1000;1l-A 
*.lCOa Return 
CC/lDai:41 42 43 44 ^5 55 DO 00 -BCDSO . . 

aoyi&osisi 5z 53 54 -for?? 

when the Monitor perform-; a memory dump, it starts al the location immediately 
following the last-opened locaUon and dispkys that address and the data value scored 
there U then displays the values of successive locations up to and including the 
location whose address you typed, h\n shows only up to fl (or l6i> values on a line. 
^■hcri it reaches a location whose address is a multiple of 8 tor 16), that is, one whose 
address ends with an 3 (or if 16, an address thai ends wid^i a 0>, It displays ihsi address 
as the beginning of a new line and then continues displaying more values. 

Ifyau have selected a large memory range to display and you wish to halt the display 
and resume entering other Monitor commands, press Control-X. This tefniinatcji the 
me tnory- range display. 

After the Monitor has displayed the value at the location whose address you specified 
En the command, it stops the memory dump and ^is that Jacaiion as both the last- 
Opened locaiion and the next-changeable Jacaiion. If the address specified in the 
input Sine is less [h.an the address of ihe last-opened location, the Monitor displays 
on[y the address and the value of the location following the last-opened location. 



Monitor memory commands 
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Changing memory contents 

The previous section shDwed you how to display the values stored in the Apple llGS 
memory system; ihis section ahows you how lo chai^gf^ those values. You. can change 
any location in RAM and you can also change [he soft switches and output devices by 
changing the contents o( ihe memory locations Sussigned to them. 



Warning 

Use these ccummonds corefiJIy. If you change the contents of mamory In any 
areo Lsod by ttie Apple Itss firmware of Applesoft, you may lose prograrrB or data 
stored In memory. You can find a map showing ttie memory use by various ports 
of ttie system software 3n the Apple Ugs Hordwaf& R&fsrencs. 



Changing one byfe 

Previous commands kepi track of the nexL-changeabIc memory locaiioni other 
memory com,mands make use of that location. In the next example, you open location 

S 1000 and Type 3. colon ( : > fallowed by a value: 

•lODO Return 

00/1000:50 -P 
• : 5 9 Return 

This entry changes the conlcnLs of the opened location to the value you requested. To 
verify the changes, again lype 

'lODO Return 

The Moniior now displays 

03/1000:54 -T 

You can combine opening a location and changing its contents into a single operation 
by specifying [he address, a. colon, and the consents on a single command tine: 

•1DD0t41 Return 

As before, you caji verify that the systeni obeyed your comjnand by typing 

*1D00 Return 

The Monitor now displays 

00/1000:41 - A 



28 



Chapter 3: System Monitor Firmware 



You can change a. byte to an ASCn code using the character instead of the numeric 
^■alue. Use ihe same syntax as before, but enclose ihe ASCII characters in double 
quotafion marks, as follows: 

To vEfify that [he IcKacion has been changed, lype 

*IDQ0 Return 

Again, ihe bartk/aiiiitess and location conleni5 are displayed. 

* 

Note that when you change ihe contents of a programmable memory location^ the new 
value that you provide entirculy replaces the value ihat was in that location \o begin 
wiih, Tlus new value wiEl remain [here until you replace iL with ancther value or until 
you turn off the computer. Funhtr information about tiiis operatjon is provLded in the 
secijon "ASCtf Filters for Stoned DaLa" laier in tlti-S chapter (If you are using the ASCII 
input mode, the filter will affect the data tint you have entered.) 

Choriglng consecutive merTiory locations 

Ypu don'i have id type a separate commriarid with an, address, a colon, a value, and a 
Etetum for each locaUon you want to change. You can change the values of many 
memory locations at the same time by taping only the initial address and a colon, 
then all the values separated by spacers, and then Return. l"he only limitation is that the 
total length of the string, including the address, coSon, all of ihe values and jspaces^ 
ind the Return, must not exceed 255 charade r§. Using this method, you could change 
100 or mors locations in a single entry line. Note that you don't need lO type leading 
istos, 3. feature diat provides even more possible data entry locations in a single 
eoeimand line. 

The Monitor stores the consecutive values in consecutive locations, stajiing at the 
liscation whose address you typed. After it ha^ processed the string of values, il takes 
ihe location following the last-dianged lcK:a[ion as the next-changeable location. 
Thus, you can continue changing consecutive locations without typing an address on 
The ncKi input line by simply typing another colon, a space, and more values. En the 
fqlJqwing examples, you first change some locations and then exsmine d^-m to verify 
llie changes. 

•lOOO^Sg 57 S'S 59 €0 61 S2 63 £4 £5 IMum 

The contents of locations 510OO through $1CI09 have been changed, as you can see by 
esajnining those iocations: 

1900.1009 Return 
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As before, the memnry-bank numbcF and ihe starting memory address precede the 
values you typed, and the A5C\l values are displayed ai ihe right 

00/LOODi56 57 5B 59 60 6] 6? £2 &A E5-VWXV '^bcde 

In the fiext examplt, you use ihe colon to coniinye a data entry, as noted in the 

preceding description; 

*1000:41 <i2 93 Ektum 

*t3t3D 32 33 Helum 

*1000.1006 Return 

0a/iaflD:1] A2 13 30 31 32 33-fl9C0123 

Note that you can entet data in either single-byie (one or two hex digits) or doublc- 
byie (three or four hex digiM) or tiiplc-byte (five or six hex digits) or quadruple-byie 
(seven or eight hen digiis) units, when a double-byie quantity is entered, ihq Monitor 
^ores the bytes in low-byte, high-hyie setTijence (ihe reverse of the way you entered 
llicm), as demnnstraled in the example G13Q entry) labove. This is. useful wht:n you aie 
specEfyfng address entries for the mini-asj>embler. You will find more of this kind of 
entry demonsiraied In the section ~The iviint Assembler" later in this chapter. 

ASCII input mocTe 

You can enter ASCII data in two diJTeiieni ways. One way is called lusral ASCII- the 

other way is called ^1^ ASCII 

<* Note: l^he ASCII filter wiL aEfect the final form of your data when ASCII input mode 
is used. See the section "ASCII Filters for Stored Data" later in this chapter for mcHt; 
information. 

To enter data in literal ASCII format, type the character string you wish to enter 
between a pair of double quotation marks. The character? you enter are stored in 
ascending order in the same sequence in which you typed them_ In some cases, you 
mighi want lo store the characters in reverise order, with the last character stored ai the 
lowest memory address. You use flip ASCII for this entry mode, Flip ASCII is entered 
by using single quotation marks in place of dfiuble quotation marks. N'ose, however, 
that flip A5CII is limited to four characters maximum. The following example 
demonstrates literal ASCII data entry: 

lOtJOj-ECHO" Return 

1000. lOOa Return 

00/lODO: C3 C3 CS CF - ECHO 

The. next example demonstrates Hip ASCII data entry: 
;OQ(r:-i:cQU' Rauni 

1000.1003 Return 

ooy'iaQO: CF ca e:3 cs - ohce 
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ASCII filters for dared data 



T. 

H ^lien you perform any manipulaLinri of ASCH code, you must consider the literal 
I ASQI format of the stored daia. For example, do you wanl the data to be stored in 
I ASCII format with the most sEgmficani bit set (to be cotnpanible widi ihe I/O firmwana 
ioT display purpos&s^ or direciJy in irue ASCH formal, where what you type eJtacUy 
;Villcrws ih& ASCn starifiard' Tht format can be changed using any filters provided by 
"jie Monitor. The filter can be any hex value from iOO Cmaximurni filtering) to SFF (ao 
fi^rin^, \l\ai 15, all source blLs pass ihrough [he filter unmodiiled). 



Format or siQr»d data 

El E2 E3 E^ E5 E6 E7 EB E9 EA EB EC 
61 62 63 64 65 66 67 68 69 6A 6B 6C 
21 22 23 24 25 26 27 2S 2S> 2A ZJ3 2C 



Ttie filler formals are as folloiws; 

Emry Fiir*r 

"abcdefghijfcl" FF CdefauU filter) 
7F 
3F 

The syntax for changing fillers is 

[fiilor-vaiu^] ^F He-turn 
Foi examplle, if you type 

7F-r Return 

die system, uses the 7F Hlier forma:, 

This means [hat when you seardi for any pauem in memory, you must know which 
TDrmat is used. If FF is used, abc appears in hex as EJ E2 E3; if 7F is iiscd„ abc appears 
J5 61 62 63. Thus, if you perform a pattern search for E] E2 E3 and the formal used was 
7F, you will not find the correci patctm. 

The input ASCII character is ANTted wilh the filter value and then stored in the search 

buffer. 



Moving data in memory 

Ycflj can copy a block of data stored in a range of memory locations from one area in 
memory to another by using, the Monitor's Move CM) command. To move a range of 
memory, you must tell the .Monitor both wl^re the data values are now situated in 
memory Cthe source locations) and where the daia values are tn^ ,gu (the desiEinaiion 
locations). Vou give this information to the Monitor by providing tiiree addresses: the 
address of ihe first tocalion in the destination and the addresses of the starting and 
ending locations witliin the sijurce range. You specify the starting and ending 
addresses of the source range by separating them with a period. You separaie the 
dcistinalion address from the range addresses with a less-than character (<), whidi you 
iRiy liik\k of as an arrow pointing in the direction of the move. Finally, you tell the 
Monitor that diis is a Move command by typing ihe letter M C'n either lowercase or 
uppercase). 

Monltof memorv commQnd& 
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TTie format of the complete Move command looks like this: 

i.deirint2Honi<[/h:^n oiidress} . [to adareii\H 

To move daia from SlOOO ihrough $1009 !o locations beginning at S2tJnO, type lire 
desUnaiion, the starting address, and Ihe ending address follnwed by Lhe letLer H. 
Note thai as you type the address values, ihe words in braces and the braces themselves 
are replaced by ihe hexadecimal addresses that you wish lo use, The example uses 
bank SOO 35 both the source and the deslinalion. You can, hnwever, .=ipecify the 
complete bank address within either of thc! source addresses or in tJ:e destination 
address, because everywhere ihal the Monitor requires an address, it will also find the 
combination of [bank/ addres^ acceptable as welL 

'2000<MG00.LDDgK Rewm 

Now examine the data you moved by using the examine procedure. Type ihe starling 
address and liie ending address and press Return: 

'P.0Q0.2Q09 Return 

'Vho data relumed to the display looks the same as it did when you cKamined locatioios 
SI 000 through $1009: 

50/20QO:CF C9 C3 C5 fiD 6L G2 G3 6^ 65-aHCE' abcde 

The Monitor moves a copy of the data stored in the source range of locations to the 

destination lorations. The values in the source range arc left unchanged. The Monitor 
remembers ihe last location in the source range as the last-opened location and the 
Tirsl location in the source range as the nexi-changcable incation If ihe second 
address in the source range is less than ihe firsi, then only one value (ihal of the Hrst 
location in the range) wjjl be moved. 

If the destination address of the Move instruction is inside the source range or 
addresses, then strange (and sometimes wonderh.i]) things happen: The locations 
between the beginning of the source range and the desiinaiion address arc treated as a 
subrange, and the values in this subrange; are replicated throughout the source range. 
Tlie section 'Special Tricks With the Monitor" later in this chapter provides an 
interesting application of this feature. 



32 



Chapler3: System Monifor Firmwore 



Comparing data In memory 

Vou can use the Verify CV) command to comparp two ranges of memory' using the 
suae formal ynu use to move a range of memory ffom one place Co another. In faa, a 
Verify command can be used immedialeiy sAer a Move command itj make sure that 
the move was Huccessfu], 

The Verify command^ like the Move command, needs a range and a desiination. The 
sjTiujt of the Vciily command is identical lo the Move command, except thai you type 
a V in place of an M: 

'dEsima:ion_aiii^TS!s\ < \sUtning nddrsis) .>. Ending addrwiW 

The Monitor compares the values Jn the source lucalions with the values in ihe 
locaions, beginning wiLh the destination address. If any values dcani match, the 
Monitor displays tlie fir^i address at which a discrepancy is Found and the two values 
that difTtrr, 3f you enter the example shown for the Move instruction and then change 
one byte at Lhe destination, you can use iJic Verify command to find the discrepancy. 
Orange the first location to hex 41 (it was hex 56) and then use the Vcnfy command: 

*2a00;fll Return 

IF there are no discrepancies, you will not get a display. In this CKampIe. because you 
wDI have caused a discrepancy, the follywing is displayed: 

Cifl/1000:56 [fll) 52000 

STODQ 

Iflcalion SIOOO contains 56; location 52000, however, contain,^ 41, 

■nie Verity command leaves the values in both ranges unchanged. The tasi-opened 
[cotion is [he last location in the source range, and the next-changeable location is 
the first location in the source rangt, just as in th£: Move command If the ending 
addre^ of the range is lcs,s than the starting address, the values of only the Hr^i 
lixaiions in the .-iource and dcstjnauon will be compared. Like the Wove command, 
iJie Verify command also does strange things if the dcsiinaiion address is within the 
Murce range. Again, sec the section 'Special Tricks With ±c MoniLor" later in this 
chapter. 
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Filling a memory fongd 

You can fill a memory range wiih i specific value by using the Moniior Zap (Z) 
command. You teU the Monitor where and how to zap memory by providing three 
pieces of Lnforrnation: the value to fill^ the starting adtlre^s, and the endirig address. 
You separate the value from the staning address by uding a Ics5-than characier (<), 
You separate ihe beginning and ending addresses of the range with a period. The 
syntax for Z-ap is 

I vaiuB) < { £iarHng_addresi} . ( ending_(uitir^s j t Return 

When Zap operaLes, the value you have setected is filled inio the entire range, 

Indudlng the starting and ending addresses. 



Searching for bytes in memory 

The Pattern Search (P) command allows you to search for one or more bytes 
(hexadecimal values, ASCn diiractcrs., or a combination of the two) Ln a rangG of 
memory. The synlax of the pattern search instmctton is as follows: 

•\{valus{sJor "literal ASCIV or 'flip ASCI!' J \<{ttarting_aftd7^s.eneiing_addTvss\? 

The byte values are entered end to end with no intervening spaces, This format Is 
required by the Pattern Search comimant! because you are looking for a string, of 
values. KcMG thaL you must enter leading zeros. For example, a soardi for the siring of 
characters OD followed by OA between locations 1200 and 1400 would be entered as 

• \aD aflV<i23D,iiiD0P Return 

If you are looking for a suing of dufacters, you can enter the chanctcrs delimited bj- 

double quotation marks as shown here: 

IT the pallern is found, the beginning iocation b displayed, For example, ff the pattern 
is located wiih its first byte at location SI 300, the following is displayed^ 

00/l-3OD:41 -fi 



34 Chaptgf 3: System Monitor Firmware 



Registers and flags 

The Apple llGS system uses a number of regiscerj? and control Hags Cbils) to perform its 

variws Eunciions. Table 3-? liSis ihese registers and flags. 

Regi&tefi and flags 



Df{jls»»r 



Flag 



Accumulalor 
Index reeisier 

Index register 
Stack pointer 
Dirca zero page 

Processor sialus 
Data bank 

Prt^rain bank 



M 

8 

m 

X 

c 
L 



Machine Stale 

AccumulaLor mode 
Index mode 
Emulation mode 
Language-card bank 



I Tte A, X, and Y regis tcra are the workhorses of the aHs-^mbly-Ianguage programmer. 

'Tl:e P regisEer contains all of the s/stem staius fla^. 'ITie D register is ihu 658^6 direct- 
page register thai cronirol* the pBacemeiit of the zero page of Lhe processor. The S 
register is ihe stack pointer. The K register contains the upper 8 bils of ihe program 
counter becuse the 65816 operates any^'here in a 24-bii address space. 

In books thai describe pnoKramming for tlic 65S] 6, lhe upper S bits nf the accumylaior 

are iomeijmes called the B regtiter These programming books also refer to ihe 1 fi-bit 

icaimula!or as the C rt^ister; the program bank register as PBR (ihe upper 8 bits of lhe 

- program counter), and ihe data bank register as Ofl>?(ihe upper 8 blLs applied to ihe X 

; uid y registers). ¥ot convenience, lhe Monitor renames these registers an rollowsi 

a The Monitor 2 register display shows the DBR contents. 

n The Monitor K nsgisicr display shows the PBR contents. 

[D The Monitor A register display .shows the l6-bit accumulator contents, whether S or 
\6 bits, 

'b The Monitor does not separately dispby the upper 8 bits of lhe accumulator. 

Note ihal the Monitor does not display the curreni contents of the program counter 
register. If you want to step or trace a program, you must creaie your own separate 
routine to display, the program counter contents along with these other registers. 
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The M register represents the machine stale. The individual bits of this rcgiS'^cr are 
described, in the summairy at the end of ihu? chapter. You can find an in-depth 
descnpijon of the meamng of diese biis in due AppU IlGS HarduiafV Reference. 

The Q regisler, also caCled the Quagmire register, is not actuaUy a hardware 
machine rcgisEer, but i pseudor^igisLer made up of conirol bils located else^-'here in 
[he system. One bit Cbit 7), selects high-speed operation, CEarlier Apple E scries 
computers operated only at 1 MHx; the Apple IlGS can operate either at 1.0 MHz or 2.8 
MIIzO Bits 6 to enable and disable varifjus shadowing nptions, Shadnwtng, when 
enabled, writes the same data to banks $00 (or SOI) and iEO (or SE1> in selected areas, 
as defined by the individua] shadowing bits. 



The environment 

The complete set of registers and flags is called the srwironmenL When your program 
encounlera a break or another kind of intemipi condition, this ^^nvir□^E^enl is saved 
hy the MonjLor. 'W'hqn you issue a command to resume execution, the environaieni is 

i^stored as it was when the interrupt oeeurred Ypur program resumes as though 
nothing, had happened, If you change the contents of ihe register^ and Hags that axe 
displayed, then ihi^i changes become the new environment that your program 
encounters when it again begins to execute. You also change the regisierH and flags lo 
SCI up a new cnvironmeni for a program that you might write and execute using the Go 
command, discussed later in this chapter. 



Examining and changing registers and flags 

The microprocessor's register contents change continuously during execution of a 
program, such as Lht Monitor firmware. Using the iMonitor, you can sec what the 
register contents were when you invoked the Monilor or when a program you were 
debugging stopped at a Break CBKX) or a COP instmction or as a result of an 
unscrviced hardware abort condition. 
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Table 3^ lisis the conmiinds ihac relate to system registers. 

Tabte 3-4 

CommofXls fof viewing and modEfyIng registers 



CBitmrmd ttrpv 



Ccmfrand formal 



Exaniine registers Contfol-E 

Modify accumulator {vall6]^A 

Modify X regisier { uiitJ6} -X 

ModiJV Y register { uall^) "Y 

Modify D register lEJfl/J5}-D 

Modify DBR rcgLster Cbartk) { tJfl^)-B 

Micidif)f program bank rcgisici { uai] =K 

Modify stack pointer {tJ&i26]=S 

Modify processor status {tnO^P 

Modify machine^suie register { vat] ^M 

Modify Quagmire register { tjal] =Q 
Modify l6/S-bi: accumulator mode {val]^m 

McxliFy 16/&-bLt index mode [Mtfl=x 

Modify native/emutaiton mode {ta/l=e 

Mtniify language-card bank {baI\=L 

Modify ASCII filler mask { val\ -F 



When you caJ the Monitor, ii stores Ihc contents of the microprocessor's registers and 
flags in memory. The registers and flags are stored in the order A, X, Y, S, D, P, B, K, 

M, Q, L. m. X, arid e. ^X^]e^ you give the Monitor a G ifLsmiction, the Monitor loads 
the registers in this same sequence before it executes ihe fitst iirstrtiction in your 
program. The m, x, and e Hags are pan of the proce^ssor fitaiu* register <P)- However, 
because the registers gnd flajHis are reloaded in die sequence shown,, whatever vsXvs you 
liave placed in m, x, and c will override any such value you might have placed in P. 

* Abfe:If you set ihe value of thee llagio !> the 658l6 automalic-ally sels the value of m 
and X to 1. This puis the processor into 6502 emuladon mode, forcing it to have an 
8-bi[ accumulator and index registers. AdditicingHy, the upper S bits of the stack 
pointer are forced to a value of 01. 

Press Control-E and then Return to invoke thi: Maniior's Examine insLmctian. This 
action displays the istored register values and flags and sets the locaiion containing ihe 
contents of the A register as the next-change abie location T:he example follows; 

•Cojitiol-E Rolum 

"Hie registers and flags are displayed as follows: 

You can change the values in any of these locations by typing the new valuCf an equal 
sign C=), and the letler for the register or Tag to affect and pressing Return. In the 
following example, the first two locations are changed, and the rcgisiets and flag bits 
ire again displayed to verify the change. 
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Change A lo the value I234i 

Change X to the value 006 A; 

-ODfiA-X Return 

Execute the Examine instnjction: 

■•ConiroUt 

The registers and flags are dj.;played Lo verify the changes; 

ft-lZ3fl X-OOSA 'i'-C3Ca S=C1F4 D-0000 P=00 B=OD K-OQ M-QC Q=aD L-1 m-l «-] *-l 

^ iVolfi If you arc using the Moniinr lo debjg a program running in 6502 emulation 
mode, ihe values for the microprocessor registers will rcvcn to their 6502 
equivalenL-s, For example, ihc A, X, Y, and S regisiers wilt be able to hold only 8 
bits each. Even if you ispedfy Cand display) a value Lhai exceeds S bits^ only the low S 
bits of the value you enter will be used when ihe system resumes 6502 emuIaLion. 



Summary of register- and Hog -modification commands 

The foHowing commands can be used lo modiEy the nsgisters and llags. Noie that all of 
thc.«: are case sensiiive. To change the regisler you wanl to change, you musi use the 
case (uppeica.se or lowercase) shown in the regisrers and llags dLsplav- The case of the 
letters is the only way the Monitor can disLinguish between flags and rcgLstere in this 
silualion (for eximple, compare X and x md M and m in ihe following Use)- 



Change lo 


Synlax 


Accumulator 


\ vaU6) -A 


X register 


[t;alJ6)=X 


Y register 


I vail 6) -Y 


D register 


iml}6]=D 


DBR register (bank) 


i vail =B 


Program bank register 


{ vaii =<K 


Stack pointer 


( i.all6] "5 


Quagmire register 


ivali=Q 


iMachine register 


{vat\=M 


m flag 


(yfl,ft-m (ml^O for l6-biE accumulaior, 




vol = 1 for 8-bit accumulator) 


X Hag 


( uai] -X Cval = for l6'bii index registers, 




va!= 1 for 8-bil index rcgisiers) 


e flag 


iPai] =e [l«^= for native mctde. 




val^ 1 Tar 6502 emulation mode) 


Filler value for ASCII tnodc.'; 


{ val\=Yf ivat = any value from 500-SFF; 




default uai = FR 


Language-card bank 


\mi)-^himi'OoT 1) 
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Miscellaneous Monitor commands 

Other Mnniux commands enable you, lo change ihe video dlspSay foirmai from 
normal co inverse and tiack and lo assign tnpul and output to accessories irs Gxpansinn 
sbw. TabEe 3-5 lists these miscellaneous commands. 

Toble ^'5 

Miscellaneous Monitor commorids 



i 



Commard lyp* 


Command ioimat 


Begin inverse video 


I 


Begin normal video 


N 


Change time and date 


^T^mm/dd/yy hhi mm-.ss 


Display time and dare 


=T 


Hcdirea input links 


is/o^lControl-K 


Redirect output links 


^SJfo/}f:^Jnt^oUP 


Change screen display to lbkl 


Conirol-T 


Change oifsor 


Control-'^ infu; cursor characcer] 


Cofiverl decimal to hexadecimal 


^i vat 10} 


Coriverl hexadecimal to decimaS 


\v&!64] = 


Perform hexadecimal maih 




Add 


tvaI6-i)-i-\vaI64] 


Subtrad 


[val6^]-{vai64] 


Mullipty 


[val64\^\fai6^] 


Divide 


[val64\ lvai64] 


Jump ID ciild-siart BASIC 


Comrol-B 


Jump lo warm-start BASIC 


Contfol-C 


Jiwip 10 user vector 


Control-Y 


Quit Monitor 


Q 



Inverse and normal display 

Toti can control ihe setting of the inverse/normal mask IcKzatJon used by the COUT 
subroutine from the Monitor so that all of iht- Montiar's ouiput will be in invorst: 

formal. The COUT routine is described in Chapter 4, "Video Firmware." The Inverse 
ccmmand (I) sets the masl^ so that all subsequent input and output are displayed in 
inverse formal. 

■I Hetum 

To switch Ihe Monitor's ouipul back to normal format, use Ihe Normal command CN). 

»H Return 
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Working with Hme and dole 

You can display of set the time and date directly from the Moniior, CNormally, Cime 

setting 35 handled ihrough the Conirol Panel, which Is described in Appendix G. "The 

Control Panel, '0 

Here is the format for displaying the lime and datc: 
™r Benirn 

If you warn to set ihe time and daie^ use the following formal (for decimal number 
entry); 

=T=-nn/ttd/yy hh-.mm.ss 

where «h is the month (range 1-12), lid is [he day (range 1-31), yy is the year (range 
0-99). Hh is the hour (rangp 0-25X mm is ilie minutes (range 0-50), and sj is the 
seconds (range '0-59), The delimiters .slash U) and tolon (:) are shown a.s the 
suggested format because diese delimiter^; conform to what a user normally expccEs to 
see. However any delimiter other than an apostrophe (O can be usetl lo separate \hc 
values entered. 



Redirecting input and output 

The Printer command, activated by Comrol-P, diverts a]l outpuE normaJly destined 
for the screen to an interface card in a spedHed expansion slot, from 1 to 7_ There 
mui[ be an interface card in the specified slot or you will lose control of the computer 
and your program and variables may be lost. The format of the comn^and is 

( siot-numher) Contro|-P 

A Printer command to slot will switch the stream qf output characters back to the 
Apple IIGS video display. 

Don't issue the Printer command us Eng a slot value of to deactivate the SO-column 
firmware, even though you used thiS command to activate ii in slot 3. The command 
works, but it just diiiconnects die nrmware, leaving some ot the soft switches set for 80- 
column display. 

In much the same way that the Printer comrmnd switches the output stream, the 
Keyboard command subsiituies the interface card in a speciHed expansion slot for the 
normal Apple U.CS input device, the keyboard. The format for the Keyboard 
command is 

[ sioi'Hutrtiier) ConltoUK 

Specifying slot number for tlie Keyboard command directs the Monitor to accept 
input from the Apple lies keyboard. 

The Printer and Keyboard commands are the equivalents of BASIC commands PR# 

andlN#. 
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^^H You can change the Monitor cursor frum a n^shmg blank spa^tt ly whichever character 
^^H yaj wish. Here is the format for changing the cursor; 

1^ 



Changing the cursor character 



CantroJ-" I new_cum}T_cfuirai:i^t^\ 

Here is an example that sets an underscofe C_? 35 your new cursor character; 

H 'Con - rol - " Remm 



The underscore now appears as [he cursor characcer. To reslore the original cursor, 
specify that ihe new cursor is a <lelt?Ee characEer, 



Converting hexadecirnol and decimal numbers 

Ydj can convert up lo 8-digLt hexadecimaJ numbers to decimal values. The synlax is 

lvaiue\-\Rciuvn] 

For example, type 

•fl&OF- Return 

Hex3,dGc]m3i S-OOOF is converted lo decimal 15: 

■A 

Vqu can also convert a decimal number lo a hexadecimal numher. The syntajt Is as 
foUaws: 



for example 



type 



•■-0015 R«ium 



Decimal 0015 is convened to hexadecimal SOOOOQOOP: 
Sa&too&OF 
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Hexadecimal math 

You can use the Moniinr in perfcrm hexadecimal msih The Apple HGS Monitor can 

handle 32-bit addition, s-ubtraction, multiplicaiion, jnd division operaiions. '["he 
syntax for Lhese operaiions is shown below. Mote ihat mutLipIie^atlon shows a 64-bil 
result, and division dL'splays both the remainder and the quotienL NdUcl- aJ^o LJuai, 
bank-address information provided in dne entry of the data is ignored during the 
calculaiions. If you wish lo actually perform addies5 ca. leu iaii oils, you can convert 
your bank and address, into a 6-digii hexadecimal quantity and use that fnr the 
calojlatians Qust leave out the forward slash). 



Op«raticin. 

Addition 
Subtraction 
Multiplication 
Division 



Syntax 

Ival64\-{val64} 
\ua!64\ * \val64] 

{vai64] [ml64] 



Return 
Return 
Return 
fte[urn CAn underscore character raiher than 



the traditional forward slash is used to specify division.) 
Here are a few examples: 
*1234^1?34 Reium 

-> sQoaojice 

'1234*39 Pdum 

-> 500001269 

-3.4 + 1 Return 

-> 500000035 

•1117.-2221 Return 

-> SFffFEEFO 

•12'3fl5STft9 Return 

-■> 5C3CiOOOOOJflE1^7A2 

*123fl5ti7S_lJCl aetum 

R~> SOOOOOODfl a-> S001D2E85 

*0/2a+l/33 Return 

-> SOOOOOOflG CBank-siddrcss information was ^grtor^3d.> 
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A Tool Locator call 

Fiom (he Monitor, it is possible to call the toolbox rouUnes. However, the lt>0lbojf 
routines wUl most often be used by pruR^amiS ralhef ihati by keyboard access through 
the Mon'ilQL The synLax for the Too[ Locator call is listed in detail in ihe summary at 
the end of this chapter. If yoy wish to use tool calls fwm ihe Monitor, see Lhe 
Appis ncs Toolbox Reference for details about the tool numbers and parameter 
ffiqiiirements for the tool of your choice. 

M an example of a pcMsibte use, here are iwo sample tool calls. The Titsl c3.I1, once 
enjcicd, allows you to lype a line of text, folEowcd by a carnage return, lliis first call 
returns a coum, in hexadecimal, of [he number of characters you typed. You will then 
sore the number you receive into a memory location and call another tool that will 
retrieve and type the characters to the display. 

Hiis first tool call icads the keyboard, staring successive chiracters in locations 
beginning in memofy location S0120S0 until you type a carriage return character. 

\c ? 1 20 ai t3FF [) eo 1 24 C\D Return 

Aikr you input some text and press Return, the Monitor responds with a hex cmint of 
lhe number of characters you typed. If you typed 

IHEE-S ARE MY LETTERS, Rcturi] 

the Monitor responds 



>!ow type the following line after the Monitor prompt id store that number you 

received into memory to set up for the tool to type the Text. The hex value that you 
enter in this memory-modification command is the same value thjt the tool retunriGd 

IS yaur character count 

jllOl/SOSO;!^ Return 

The following commajid ai;ks a tool to type the text 
\3 □ 1 20 30 ic C\D Return 



Bock to BASIC 

Use the BASIC command, Control-B, to leave ihe Monitor and enter the BASIC that 
was active when you entered the Monitor_ Normally, ibis is ApplesofL BASIC, unless 
you deliberately switched lo Integer BASIC, Note that if you use this command, any 
:■-■- £fam or v&riables that you had previously entered in DASIC Tvill be lost. If you want 

.-■ -ccnDer BASIC wiih youf pmvioui pfegmm aad vaftgbles imaet, use th^ CoHtiiiue 

If' Basic command. Control-C. 

If you are using DOS 33 or ProDOS*, press Control-Reset or use the Monitor Q (QuiO 
■command to return to the language you were usin^ with ^four program and variably 

irtact. 

Miscellaneous Mon.^tor commands 
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special tricks wfth the Monitor 

lliis section describes spme more complex wayjs of using the Monitor commands, 

including 

D placinjij multiple commafids on a single command line 

D Filling memQjy with a mulii pie-byte pattern 

D repeating commands 

n creatJng your own commands 




Multiple commands 

You cifi pui as many Monitor commands on a single line as you lihe, so long as ycftj 
separate them with spaces and the tola] number oC chiraders- in the line is Jess than 
25^ Adjacent single-letier commands such as L, S^ t, and N need noi be separated by 

spaces, 

You can freely mix alJ of ihe commands except the Store (:) command. Because the 
Monitor lakes all values following a colon and places them in consecutive memory 
lorations, the last value in a Store command must be foLowcd by a letter command 
before another address is entered. Yoti tan use the Normal command as the letter 
command in such cases^ it usually has no efiecc on a progtam and can be used 
anywhere. 

In the following example, you display a range of memory, change lij and display it 
ig^m, all with one line of commands: 



■1300.1307 130C:3fl 23 1 M 1300.1502 Eetum 
CO/1500 - 00 oa 00 OO OO 00 00 DO 3S 39 01-.... 



.. ^89 



IF the JVfoniior encounters a charaaer in the input Lne that it does not recognise as 
either a hexadecimal digit or a valid command character, it executes all the 
commands on the input line up to that character. U then grinds to a halt wjih a beep 
and ignores the remainder of ihe input line. 



44 



Chapter 3: System Monitor FJrmwafe 



Filling memory 

The Move command can be used lo replicate a fHLtem of values throughout a range of 
memory. To do this, first store ihe pattern in the Tirsl locallons in the range: 

'UO0,-n 22 33-. "3 

ft 

Eemembcf the number of values in the pattern; in this case, ii is 3- Use this number to 
compuce addresses for ihe Move command, like ihiS; 

(iOirt-numher'i <m(ar1l . {end- number} H 

This Move command first replicaies the pattern at the locations immediately following 
the onginial pattern, then replicates that pattern following the first replication, and SO 
on urnil ii fills the entire range: 

•13D3<13aa.l33^M 

*L3CO,U37 Relum 

DDA300 - 11 22 33 11 22 33 11 22 33 11 22 33 11 22 33 11-, "3, "3 , "3. "3 . "3. 

00/1310 - 22 33 11 22 33 11 22 33-"3,"3."3 

r 

Vou can perform a similar trick with the Verify command to check whether a pattern 
repeats itself through memory- Verify is especially ascful for verifying that a given 
;ange of memory locations alJ contain the same value. In the foUowing exarnple, you 
flj^t fill the memory range from. S]30O to S1320 with zeros and verify it- you then 
change one location and veriFy it again: 

n301<:13C'3.132SH 

'1301<;13C<!. 1320V 

'1301:32 

'1301^1300. 1330y 

13G3 - 00 (0211 

1304 - 02 (Ofl) 



*nK Verify command detects the discrepancy. 



Special tricks v/Jth the Monitor 
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.sfe "i ^^smis^^^miw ^^'^M^^.. 



Repeating commands 

You cafl creaie a command line Ehal conlinuously repeals one or more commands. 
You do this by bcginnimg the piri of Ihc command line that you warn to repeal wiih a 
lt;ller command, such as N, and ending il wilh ihe sequence 5^:n, where n is a 
hexaUeciniai number ihal specifies ihe posilion in ihe tine of Lhe command where yoii 
want to start repeating. For the first diaraeter in the line, n = 0. The value for n must be 
followed by a space fof the loop to work properly. 

This uidk takes advantage of the fact lha( the Monitor uses an Index register to step 
through lhe input buffer, starling ai location $0200, Each lime the Monitor executes a 
command, il slores Lhe value of the index al location SIA; when that commancl is 
finished, the Monitor reloads [he index regisier with ihe value ai location 5^4. By 
making the last command change the value ai iocaiion 534^ you change this index so 
Uiat the Mnniior picks up the next command character from an earlier point in the 
buffer. 

ITie only way to stop a loop such as th^ is to press Control-Reset; that is how the 

following example ends: 



"H 1300 


13D2 3i3:D Return 


1200 


- 


11 


1302 


- 


33 


IjOD 


- 


n 


1302 


- 


33 


1300 


- 


11 


1303 


- 


33 


13Q0 


- 


11 


1303 


- 


33 


1300 


- 


il 


1302 


- 


33 


1300 


- 


11 


1302 


- 


33. 


130 




CConlTol-Ri 


1 







CConlrol Reset is pr&s£ed here; the MonlLor jumps to ApplesofL) 
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Creotlng your own commonds 

The User command, Contiol-¥, forces the Monitor io jLimp to memory' location 
5051^. Ydu can pui a JMP instrjction there thai jumps to your own machine-Unguage 
prograni. Your program can then examine ihc Monitor's. rcgLsLcrs and pointers Of the 
ixip«t buffer stself to obtain its data. For example, the foJlowing program displays 
cvepflhing on ihc inpui line after Conirol-Y. The program starts 3L localion S0300i ihe 
command line that starts wiih J05F8 stores a jump lo SO^OO ai location i03F8. Here is 
the program,, followed by a listing of the method by which it is entered inlo the 
Monitor 



The program: 


IDX 


34 


HOHE IDA 


200.x 


JSR 


COUT 


I NX 




CHP 


ASO 


BNE 


MORE 


JKP 


MOtJZ 



jGet the index from location S3^ 

;PDint& to n&Jtt charicteE poaition Ifi iriput line 

;Set that character into iiccunuldtor 

;Output the character 

;pDlnt to the nent character 

;3bb if it is a carriage retucji 

;If not, go get more 

;Jump ro atandard monitor encry point (call -151] 

Entering the program Into the Monitor: 

•300:A4 34 BS 2C0 ZQ TDED CS C& flD DO F5 4C PF64 

*3rfl:4C 300 

•Coatcol-Y THIS IS A TEST 

THIS IS A TEST 

* 

NoUce that the target addresses Tor ^e JSR (jump lo subroutine!) instmctions (value of 
hex 20) are entered directly as their 4-digit hexadecimal values rather than as separate 
b>ie pairs in reverse order as would normally have been required for the stys'siem 
Monjlor in machines prior to ihe Apple IIGS. You can ertler fu!l 32-bit addresses in 
this manner if you wish Cup to fl hexadecimal digits, forming a 32-bit quantity). 



SpecliQl tricks with the fvtonltor 
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Machfne-languoge programs 

The main reason [o program in machine language !S to gel more speed. A progfam in 
machine language cm run much faster than the same program wrinen in high-levet 
language.') such a-s BASIC or Pascal, but the machine-tanguage version usually isk&s a 
loi longer lo write. Tliere are other reasons to use machine kn^agg: You might wart 
y{jur program Lo do something thai isn'i induded in your high-level language, or you 
mi^l just enjoy ihe challenge of using machine language lo work directly on the bits 
and byies. Ii is highly unlikely that a serious software developer will use the minj- 
assembler lo produce large programs. Tlowever, the mini-assembler is a useful lool 
for quickly checking various basic concepts. Someiimes just the ability to examine 
memory is very handy. 

♦ Note: rf you have never used machine language before, you'll need to leann the 
language of ihe 65C816. To become proficient in machine-language programmiing, 
you'H have to spend some lime working with it and study at fcasi one book on 
65CS16 and perhaps also 6502 or 65C02 programming. 

You can gei a hexadecimat dump of your prngram, move your program around in 
memory, examine amd change register contents, and so on using the commands 
described in ihe previous sccilons- The Maniior commands in this JsccUon ar^ 
intended specifically for you to use in creating, writing, and debugging machine- 
language programs. Table 3-6 lists ihe commands that relaic to program creation and 
debugging. 

Table y6 

Commands for progiam eifecuflon and debugging 

Command typ» 



Command format 



Go (begin) program in bank SOO 

Execute from any rr^mory bank 
Restore registers and flags 
Resume execyiton 
Perform a program step 
Perform a program trace 
Disassemble (li&O 
Enter mtni-assemblcr 



{Startadiiress iG 

{ siart_iiddress \ X 

Control-R 

istarl_address]R 

{siart_iiiitiress]S 

{stari_address\T 

1 
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Running a program tn bank zero 

The Monitor command you use lo sizn execution of your machine-lajiguage program 
as the Go command. When you type an address and ihe letier G, the Apple HGS 
restores all of the machine i$gis[eT5 From iheir stored locations and begins execuUng 
machine-language inslnictions stirting a[ the specified location. If you type only G, 
cKecution siarts ai [he la&t-opened location. The syniax of the Go command is 

{siaTt_aii£irsss}G R^um 

The Monitor treats this program as a subroutine and executes a JSR to the program, 1/ 
you want the routine to end by recumifig cohlrol [0 the Monitor, your program must 
end with an RT5 (return from stibroutine) instruction to Lransfer control back to the 
iSlonilor. 

The Monitor has some special features that make it easier for you to write and debug 
machine-language programsi but before you learn about thesCj here is a smaJl 
Fnachtne-language program thai you can run using only Qic simpCe Monitor 

commands already tfescxibed. The program in th(? example displays the leuers A 
thrcsugh 7., Store it starting at locauon iOJOO, examine it to be sure you typed it 
correcdy, and then type 3 00G to start it running. 



•:iaC:A9 C3 20 FDED IB S9 1 

^SaCG Return 

abcde f gh t j Jt Icilft Opqr St UVVKy e 



■c9 DB DO F6 fiD Return 



This is the assembly code that represents the precseding hand-assembled program: 



OCT 



LDA itCl 

JSR COUT 
CLC 

ADC #1 

CHP ItCfB 



;Place ftSCI] C&e "ft" IjiLd accumuLetor 
(■Note; Mini^assembler does not use labels 

Add 1 to cofitenEa oE accL^muiator 

Comparfl cofltertts to a value of ASCII l"Z"+ll 

It nsEj ge feask and oaEptit igeum value again 



The G instruction works only for code in bank $00. The system bcffips if the user 
specifies ^ny bank other than SW. The G inslrucUon sets up a JSR io the code and 
expects this code to end in an RTS. 



Macinlne-longucige programs 
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Runnfng a program in other banks of memory 

You can run programs in banks other than bank $00 by using the X cornmand insiead 
of the G command The X conumnd restore? all of ihe machine fegi'stGrj; from their 
stored locations and begins executing at the specified location. A JSL instruction 
Qump lo subroutine long) is p>erfonned instead of a J5R, and die user's code is 
expected to end with an RTL Cietum from subroutine long). The synax of the X 
command Es 

[Start acidr^si'x Return 



Resuming program execution 

You can resume e:fficij[ion of programs halted by a deliberale RRK (Break) Enstruaion 
or Trace command by using the H cammLand CResurne;). Run programs in banks, other 
ihan bank SOO by using the X command instead of the G command, The R command 
restores all of the niachine regisifis from iheir siorGd locaijons and begins execuiing 
aE the location you specily, A JMP instruction is performed instead of a JSR or JSL 
because the; Resume command aisumes thai you do not intend lo return to the 
Monitor 



I 



Slepprng through or tracing program execution 

The Apple CGS Moniioj" includes two commands for stepping through a program one 
instruction at a time and for [radng program execution Cperforming multiple steps). 
You put the Monitor into Step mode by using the S command. Ynu pui the Mnniior 
into Trace mode by using ihe T command. CThese commands, though present, are 
not fully implemented.!) The Step command prints "STEP" and return^ control to 
die JWonitor. The Trace command prims "TRACE" and returns control to Lhe 
Monitor. If you want to implement your own Step and Trace functions, simply modify 
the Step and I'race vector Eocations to point to your own custom version of each 
routine. These veaors are shown iti Appendix D, "Vectors." The fonnats for Step and 
Trace are shown in the ifummary al the end of this chapter. 
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The mini-assembler 

Hie Apple IIGS miniassembler included in the Monkor program allows you co enter 
ria chine language programs direcily from line keyboard. ASCII chafaaera or hex 
viiucs cari be eniered into a mini-assembler program cxacily as you enter (hem in the 
MoniLor, Tho mini-assembler doesn't accept labels; you must use actual values and 

addresses, 

^^ben you enter the minl-asseinblcr. ihc Monitor prompt character changes horn * 
to ! Cthe mini-asaemhler prompt) and assembles the first line of code (if a line of 
Code is typed on the same line as the eKdamation point t-hai caused the mini- 
assembler to be entered). 



Starting the mlnl-ossembler 

To start the mini-assembler, first invoke the Monitor from BASIC by typing 

Call -151 Return 

Then, from the Monitor, type 
I Return 

or 



Using the mlnl-assembtdr 

The mini-assembler saves one address, that of the program counter. Before you start 
typing a program, you must set the program counter lo point to the location where you 
want [he mini-assembler to store your program. Do this by lyping the address 
followed by a colon. Tlien type (he mnemonic for ihe first instruction in yout 
program, followed by a space and the operand of the instruction. 

!JO0;T,D>: *02' Rclum 

The mini-assembler convcrLS the line you typed into hexadecimal format, stores it in 
mciiiniy beginning at the location of the program counter, and then disassembles it 
again and displays the disassembled line. The prompt is then di&played on Lhe next 
line. 



00/0300- A2 02 



LDX 



i&2 



TThe nntnl-cjssernbler 



The mini-assembler is now ready 10 accept [he second insifuction in your pfogram. 
To tell it thai you want the next instruction to foLcrev' ihc first, don't type an address or a 
colon; type a space and the next insLruction's mnemonic and operand and dien press 
Return. 

The first "Space after the exdajnaiion point ( ! ) controls the nature of the digits that 
follow; 

□ A space means you warn ihe newt snstaiciion lo rollow the first. 
n A colon CO means, hexadedmal infyrmaUon fylfows. 

n A double quotation mark (") nutans ASC[1 iitformation fotlows. 

□ A number meani; an address fgllqw;, 
"Hie llr^i insinjcUon Is as follows; 

f LDA $0, X Ueium 

The mini-assembler assembles that line and Is then ready for the next instruction, 

00/0302- B5 00 LOR 00, X 

I 

The following example shows the procedure for entering a program using the mini- 
assembler. The instruction,^ you lype are shown on a tine with the prompt character 
CO; the assembled display is shown, in each case, on a line without a prompt 
character. 

ijQOiLDX #oa 

0a/03ac- A3 D2 LDK *02 

! LDA C,X 

00/0302- B5 DO tDft 00,^ 

I STft $10, X 

00/0304- 95 10 STR 10,X 

I D£K 

00/0306- CA DEX 

! STA 5C030 

00/0301'- B3 30 CO STA C030 

! BPL $202 

00/030A- 10 F€ BPL 0302 

t BRS 00 
00/030C- Oa □□ BRK 00 

<* IVote. Don'L forget the space after the exclamation point. The program needs the 

space after ihe exlamaiion point to follow the address precedent set by the tnicial 
instruction. 
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If you want lo enter & progranj in hexadedmal notation, you musL start in the hex 
mode, as the following example indicares^ 

tfiO Gl CL 

If an instruction line has an error in ii, [he mini -assembler beeps loudly and displays a 
Csrel (") undef at near the offending diaraaer in the input line. If you forget the space 
before or after a mnemonfc or include an cxiraneous character in [he hesadecimal 
value or address, the mini -assembler rejects the inpul tine. If the destination address 
of a branch instryclion is out of the range of the branch (mcme ihgn 127 locations 
distant from the address of ihe instruction), the mini-assembler flags this as an error. 

To leave the mini -assembler and reenter the Monitor, press Return immediately after 
lite ! prompt. 

Your assembly-language program is now stored in memory. You can display it with 
the List CL) instruction as foliows; 






'3Q0L 










l=m l- 


X 


l=LCBa 


Ak(0/Il 




ilD^530O- 


M 


02 


LDX 


#0? 


aof'cao?- 


Bh 


DO 


LDft 


Da,x 


0U/03O^- 


93 


ID 


STft 


10. J£ 


0*/Ci3O6- 


CA 




DEX 




0(l/D3OT- 


8D 


30 CO 


STfl 


C030 


O0/O3OA- 


10 


rfi 


BPL 


0302 


D0/O3DC- 


OC 


00 


BRK 


OG 


&CI/03QI:- 


00 


00 


BRK 


00 


iiij;ijj.i2- 


00 
00 


00 
00 


SRK 


DO 
00 


io;o3n- 


00 


00 


BHK 


DO 


iO;03.1€- 


00 


00 


BRK 


DO 


■jDVoaig- 


00 


00 


BRK 


00 


awaaiA- 


00 


00 


BRK 


00 



CAflCT \hc DToerafn is disrda.yp.ci ihe t.ift irvunti-tif^n 
atsplays enougn J inc5 ofcode to nil the scriarn.) 



The mlnl-QssembJer 
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Mini-ossembler instruction formats 

The miiii-aAscmblcc recognizes 2l>6 mnemonics and 24 addressing formats. Table 3-7 
shows ihe address formats for ihe 65Cfil6 assembly language. CMini-aiSSenibler 
opcodes aic listed in Appendix F, "Disassernbler/MIni-Assemblcr Opcodes. 'O 

TabI* 3-7 

Mlnl-oas&mbler address formats 



Mod* 


Nam* 


Forma! 


a. 


Absolule 


1254 


3,X 


Absoluie indexed (with x) 


]234,X 


a,y 


Absolute indexed Cwith y) 


1234,Y 


U.x) 


Absolule indexed indirect 


(la^-i^x) 


al.x 


Absolute indexed long 


OS1234,X 


Ca> 


Absolute indirect 


Caso 


al 


Absolule long 


031Z34 


Ace 


Accumulstor 


Blank 


xya 


Block move 


01,02 


d 


Dire a 


'i5 


d,x 


Direct indcKed Cwith x) 


45.x 


d,v 


DIrea indexed (with y) 


45.Y 


Cd.x) 


Direct indexed indirect 


05.X) 


(dD 


Direct indirect 


(45) 


(d},y 


Direct indirect indexed 


(45) ,Y 


ld],y 


Direa indirea indexed long 


N51,Y 


fd] 


Direct indirect long 


[45] 


# 


Immediate 


#25 or #2345 


i 


Implied 


Blank 


r 


Prosram counter relative 


lOOO 1+50} 


rl 


Program counter mlative long 


tooo :-o2oa} 


s 


Stack 


Blank 


r,5 


Stack relative 


10. S 


(r,s),y 


Slack relative indirect indexed 


C10,S),Y 



An address consists of one or more hexadecimal digits. The mini -assembler 
interpreL'5 addresses the same way the Moniior does: If cne, three, or five digits are 
entered, a preceding zero is atiiomatically enlcicd as well. For example, tlie 
insuuaion LDA *] is assembled as A9 01- 

♦ Note: The dollar signs ($) ysed in this manual to signify hexadecimal notation are 
ignored by the mini-assembter and may be omitted when lyping programs. 
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Branch instnjciions. which use Lhc relaiive addressing mode, require Lhe Largei 
address of the branch. The mini-assembler auiomatjcatly calculaLes lhc relative 
distance Co use in the insiruciion. Tf the target address is more than the allowable 
dLEiaocc from the current program counter, ihe miniassembler sounds a beep, 
d:splays a caret C'^) under the target iaddrcss. and does not as^emible the line. 

If you give the mini-assembler the mnemonic for an irLstruction and an operand and 
the addrt^ing mode of the operand cannot be used wiili the insiruclion you enteredt 
the tnini-assenibler will not accept the line. 



The Apple IIGS tools 

As you are creating s. program, you will very likely wani to incorporate calls to various 
Apple IlGS rools into your program. To use the tools, you need an intimate knowledge 
of the tools themselves. You should therefore consult the appropriate Apple IJdS 
Tboibox Heference manual for informaiion about ^2ach tool. The Monitor includes a 
Toa[ Locator tiati as one of the commands. The format and details are given in the 
command summary at the end of this chapter. 

The Tool Locator command aauaUy performs a caJl to the selected too!, performs the 

desired function, and provides you with debug information about the daia that the too! 
provides as return values. 

The Tool Locator cail iets you type a one-line command instead of requiring that you 
create a program to test the tool. See the A^le IIGS Toolbox Reference for more 

Lnforiiialio n . 



The disassembler 

Because hexadecimal code is so difficult to read and understand, you may want lo 
uanslaie machine language back into assembly language, You can use the List 
itJSLmction as a disassembler for this purpose. 

The Monitor List instruction has the format 

The LL5t instruction starfe at the specilied loaiion and displays a full saeen (20 lines) 
of instructions. For example, if you want to display a Ust of instructions starting a[ 
location SiOOO in bank 12, type 

*12/iaoaL Return 



The dlscss^mbter 



55 



The foilowing list Ls displayed^ 



0-JH 0' 


=JI 


l-^LCBdnk 


(0/11 




12/1000 


AD 


13 


is 


LDA 


1915 


12/100^ 


9D 


50 


10 


STA 


10aQ,K 


12/1006 


9F 


50 


32 Oh 


STA 


0^3:^50 


IZ/lOOft 


h9 


n 


6t 


LDA 


16671 


12/lOOD 


S2 


20 


10 


BRL 


2030 1+1020} 


12/1010 


SO 


2D 




BEUl 


1Q32 1*20] 


12/1012 


F4 


12 


34 


PEA 


3^2 


12/lOlE 


62 


10 


10 


PER 


2023 


12/lDlS 


37 


flS 




STA 


[^51 


13/lDlft 


^2 


DO 


FO 


PER 


001& i-1000} 


12/lOlD 


A9 


23 




LDA 


#0023 


IZ/IDIF 


A2 


93 


G7 


LDK 


#6745 


1Z/10J2 


4F 


54 


1i 02 


EOR 


0244654 


12/1026 


DC 


S9 


23 


JML 


(23891 


12/1029 


7C 


BE 


P2 


J3R 


IF2BE,X) 


12/102C 


73 


40 




ADC 


!fla.S],Y 


12/1D2E 


CI 


□ E 




CMP 


!06),Y 


12/1030 


Qh 






ASL. 




13/1031 


00 


23 




BRK 


73 


13/1033 


BB 






CLV 





The top line of the disassembly show$ ycju [he currenl sellings of [he m and x bits of the 
65CB16 status register. Recall that you set these bits by ujiing the \ pai] =in and ( vol] =x 
Monitor commands. Both affect Lhe way the disassembly is performed by the 
Moniior. The LC Qanguagc^card) bank infomnation shows you which of the two 
available language-card banks is cuneniJy active. You change [he language-card bank 
by using the { vai\ =L command. 

The disassembler can disassemble all 65C816 opcodes in emulation and native modes 
(boLh &-bil and l6-bil naLive mode). Ln either riative or emulation mcx^e, the sizes of 
the accumulator and index" registers are significanL In immediaiB mode, Lhe sizes are 
imiponant for the opcodes listed in fable 3^. 
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Olsplcry Memory Locafion 

( from^ address \ 

Displays coments of memory locallon as 

Display Range af Memary Locations 

Displays memory. 

In 40-column mode, type 

*20/40i. ^33 

Memory contents froni $0"(01 in bank ZO lo V^A\l in bank 20 are displayed in 
4Q-culumn made: 

ZO/O^OliCl C2 C3 CI C3 C6 C7-ABCQEFG 
2a/C1[JB:C8 C9 CA CB CC CD CE CF-HIJKLMNO 
20/0410:00 Dl O.J 03-PQ. 

!n SOnzolumn mode^ type 

'20/4 01.42 

Memory contents from $0401 in bank ZO to SCUl^ in bank 20 are displayed ifi 
SO-colutnu mode: 

20/aflDlTCl C3 C3 Cf; CS C& C"? C8 C9 CA CB CC CD CD CF-AHCDEf GKI JKOLMNO 

2n/G'91GTDQ Dl 0? I>3 □< 05 06 07 D2 D3 D4 D5 D€ D1' Dfl D9-PQ HSTDVWXr 

5D/Oi9?0:El ES-gbcd 

♦ Abie- Pririiable ASCII characters are output as normal ASCII characters. 

Nonprintable characters are Civlput as periods. In 40 column mode, half a page of 
memory can be displayed; in SO-coliimn mode, a full page of memory can be 
displayed. 

Terminote Memory Range 

Contfol-X 

Tenninates Display Range of Memory Locations command. 
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Cmicao Return 

Performs a cajfiagc rclum wlih no preceding entry. 

It 40-columni mode, di-SpUys ihe contents of up to ihe next 3 locations in bejcadecEmal 
ind ASCII formais. CLocation sLarts at 5asi [bank/ addrsss\ eniered and continues 
un^jl the low nibble of ihe addresses being displayed equals or 8J See formal of 

Display Memory Location command 

In Kt-column mode, display.ii the crtntenis of up to the next 16 locations in 
bexadecimaJ and ASCII formats. CLocation stariii ai [he last i bank/ address} 
enieced and continues until the low nibble of the addresses being displayed equals 0.) 
See fomiat of Display Memory Location comm&nd, 

Mfrve. M 

Moves data from \Jmm_address] through I lo_a£i£iress\ to locations starting at 

I destination \ .. 



%^ 



(fllffirtHdriOB J < [from address) , ( to_a^rHSJ^ V 

Compares [he memory contents starting at { desiinatifm] through 

\iiBS[maiion\^i{to_addres5 - [from_&ddTeS5)'^ with the memor>' contents starting 
at \froTn_address\ through \ ifi_addr£ss\ and verifies that ihey are the same. 

Fill Memgrv. Z 

I vai) < ifmmjid^re&s ] . { lo_address ) ?. 

Fills memory in the range {/rom_atldrieis\ through [ to_address} with the ]-by(c 
value [vol]. 

PcfHem Search, P 

\i.rairi ]"!ireralA.SC{I-'] (. ' 123f ) <va^\\<l/nmt_tidiir0a) . \ta_iKUres3]9 

Searches for any length pattern up lo 2^6 bytes in memory ranging from 

i/rnm_address\ through { la^address] ■ \mt] can be hexadecimal, liieral ASCII, or 
[tipped ASCII. The address of each location whtre the pattern is found is output to the 
screen followed by a cajriage return, The pattern search continues until the entire 
mji^^e of addrtv-jses has been examined- 
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Examine Registers 

ConiroJ-E 

Esimines 65C816 regilters and dags. 

The screen displays 

A— -dB-a a X^xxjt k Y-yyyy S~S33S. D "dddd P -"pp 
B-lAi K-isX M-mm Q-qq L=l Jn=m x=x e=B 

On a 40-column screen^ two lines are displayed automatically; on an fiO-column 
screen, only one line i-s dliiplayied. 

Chonge the A Register, A 

Change-s A register value lo {vall6\ for Resume/Go/Execuce/Siep/Trace commands 
Note: A must be uppercase. 

Change X Regista, X 

[vail 5) ^X 

Changes X register value to \vall6\ for Reaume/Co/Exepjt-e/'Slep.Trace commands. 
/WQte-' X muji[ be uppercase. 

Change Y ReQister, Y 

Changes Y register value to \vall6) for Resume/Go/Execuie/Siepn/Trace commands. 
NotE: Y tfiuit b(? uppercase. 

Change D Regisleip D 

Chang&s direct-page/zero-page regisier value to { vall6\ for 

Resume/GoyExecute/Siep/Trace commands. Not& D must be uppercase. 
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IChonge Dota Bonk Register, B 



Changes data bank register value to [val] for Resume/Go/Execuie/SiepArace 
commands. P^'ote. B must be uppercase- 
Change Program Register. K 

{H!l/f=K 

Changes progfiiti register value to {vai\ for Sesume/Go/Execuie/Siep/Trace 
commands. Note: K must be uppercase. 



Chonge Sfock Poinfet. S 

\ixUl6i-s 

Changes stack pointer value to \vail6] for Resuroe/Go/Execuie/Sicp/Trace 
commands, ,'^oie: 3 must be uppercasc- 



Change Prdceuof StOFtus, P 

Changes processor status value to [ vai) for Resume/Go/Execule/5lep/Trace 
COmrnunds, A'ofe.' P mu5l be uppercase. 

Change Machine Stale, M 

changes machine-stale value to ival] for Resume/Go/Execute/Slep/Trace 
commands. ?vole: M musi be uppercase. 

the M bits arc as follows: 

Bit? = 1 Makes alternate :£ero page/LC active 

Bit 6 ■ 1 Makes Page 2 active 

Bii 5 = 1 Makes RAMRD aclive 

Qil -^ = 1 Makes RAi^ra'TlT active 

Bit 3= 1 Makes RDLCROM active, not read/write — read only 

Bit 2 = 1 Makes LC bank 7 active 

Bit ] - 1 Makes alternate; ROMBANK active 

BEiO= 1 Makes INTCXKOM active 
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Chong^ Quagmire StoTe, O 

Changes Quagmire state value to { val] for Eesume/Go/F.secuie/ScepA'race 
commaiids- (Ttie Quagmire value conirols shadowing and system speedX 
Note-. nvjsi be uppercase. 

The Q bits arc as TolJawS: 

Bil 7 = 1 High speed 

Bil 6*1 StopLS lOLG shadowing 

Bil 5 = AiuJiTffs musi be 

Bil 4 = 1 Stops auxiliary-niemory Hi-Res shadowing 

Bil 3 ■ 1 Stops Super Hi-Res shadowing 

Bil 2 = 1 Slops I li-Res Page 2 shadow'ing 

Bin - I Slops Hi-Res Page 1 shadowing 

Bit -^ I Sropis text Page 1 shadowing 



Change Accumulator Mode, m 

Changes iccumulitor mode value lo li/al} for Resume/Go/Exeojte/Step/Trace/List 
Commands. Nole: m must be tow^rcaw, 

= l6-bit mode 

1 ■ 8-bli mode 



Change Index Mode^ K 

Changes index mode value to {fa!] For Resume/Go/Execute/Step/rrace/Usi 
commands. Note: x must be lowercase. 

= l6-bii mode 

1 ■ 8-bit mode 

Chonge Emulation Mode, e 

Changes emulatlon-mode value m lval\ for Kesume/Go./ExecutE/Step/rmce/L!5l 
commands. Note: e must be lowercase. 
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Change Languag#-Card Bank, L 

Changes language-card bank value to [val] for Resiiine/Go/Execute/SlepA"race/li3t 
[nmmands. Note.- l. must be uppercase, 

iQ = First bank of language card 

1 ■ Second bank of language card 

Change FEIter Ma^, F 

Changes the ASCTI filler mask viEue to { iJa!] for minl-assemblcr ASCII entry and 
MoiiitGi' ASCII imm-cdiaiC'inode commands. The ASCII filter is ANDed wiih ;ill ASCII 
characters entered in ihe Monitor. Affeo^ both data entry and search conditions. Any 
value from $00 to $FF is valid. /Vo/e. F must be uppercase. The default va:Iue is FF. 

Change Te^xt Display, I (Inverse) 

I 

Switches to inverse video text display Note.- r inust be uppercase. 

Change Text Disjiriay, N CNormol) 

Switches to norma] video text display, Noie. N must be uppercase. 
Display Time and Dote, T 

Displays curnsnt Ume and dale. Note; T must be uppercase, 
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Change Timo and Dcrfe 

Changes time. Atofe, t must be uppercase. Any delimiter except an apostrophe (*) 

may be used between values entered 

Emer 



h*) = hours 


0-23 


mm " minutes 


0-59 


ss = seconds 


0-59 


Wi = month 


1-12 


dd = day 


1-31 


yy -year 


0-9? 


Redirect Inpui Links. K 


(yio(} ConiTDl'K 




Redirects Input J 


inks tq [ 5/011 



Redirecl Output Unks, P 

{ihat\ ControJ-P 

Redirects output links to (j/oil . 

Change Consecufive Memory 

\baT\kfaddfeii) -Avals ivali luali {"literai ASCII") r/ipASC'II' 



vah 



Changes consecutive memory locations starting ac [ bank/ address} to the values after 
the colon ( :) Vatues can be in hex, literal ASCII, or nip ASCII format. 

Chonge Screen Display, T 

Conlrol'T 

Changes screen display to text Page 1, regardless of current soft-switch sellings, 

CtiangeCursof 

CcmlroUj^ ^ character] 

Changes the Cureor to a {character) symbol. This command is implemented through 
COUTl and C3COT.1T1. It is not an Input command; it works only through ihe BASIC 
output links. !f {charade] is the Delete characLer^ the origing] cursor is rcsioifed. 



Ci 
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Conven KexQdecinncil to Oecimal Format 

^Miverts hexadecimal number entered to decimal number CB-digic hex number 
naximum) Result is prinwd Staiting al firsL column on next line. 

invert Decimcl to Hexadecimal Foinrrat 

-'[milO'i Return 

-{kirverLs decimal number entered to hexadecimal numtjcr {lO-digit decimal number 
i-saximumX Result is printed .starting at fiisc column on next line. Entries may be 
'signed C+/-) or unsigned. 

Jimp to Cold Start 

.CcatioJ-E 
Jnconditfonalty jumps lo BASIC5 cold-slart routine at ROM kjcition 3E000, 

Jiffnp to Woffm Start 

.linconditioniLtly jumps lo BASIC'S warm-start routine at ROM location $£003. 
Jumpio User Vector 

•Control ¥ 

Unconditionally jumps lo user veoior at S05FS. 

Ouft Monitor, Q 

discontinues Monitor operation. Unconditionally jumps to SiW lo warm-start the 
"eriting sysiem. 



1 Piogram in Bank $00, G 

■ ',SULrt_addiVSS}G 

.Transfers conlrot to the machine-language program beginning at {3tart_ad{iress.i . 

■}.5eis the environmeni from stored locations A/X/Y/S/D/P/B/K/M/Q/'L/m/x/e; 
[™.5Ses RTS information on ihn user's stack and performs a JMP to {siart_address\ 
with RTS information lleFl on the stack Conly works for code in bank lOO becau-se it 
assumes user's routine ends in an RTS). 

Bumnnnarv of Mornltor Instructions 
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Reset the Environment and Transfer Control, X CExecute) 

Retrieves ^/XTf/S/D/F/B/K/M/Q/Um/x/c dala from siored iMaiions, sets ihose 
daia is the enviranmenl, pushes HTI- informaiion on the user's itack, and performs a 
JMP to {staTi_atii^rs^] wcih RTl informaiion on Ltie sLack iworks for code in any bank; 
assumes user's code enc^ in an RTL), 

Restore Registers and Flags 

Con I to! -H 

Reslores registers and flags to the normal Monitor configuraUon mode Changes 

A/X/Y/S/D/P/B/K/M/Q/L/m/x/e, 

Reset !tie Environment and Transfer Conljol. R Cftesume) 

Sets the environment from stored locatiqus A/X/Y^S/D/P/B/K/M/Q/l/Wx/e and 
jMPs [ij [stan_aa(iress] , 

Peiform a Progiam Step, S 

[ starl_addre^i\ s 

Not implemented in current version, 

Perform a Pro^rort* Tioce. T 

[ stJin £fddress \ X 

Noi implemented in current version. 

DisQssernble, L (List) 

[iian_adciress\l. 

Disassembles up to 20 jnslnictions starting at location [sian address]. 
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Toof Locator, U 

Mbytes to s^Jt bytes frm sAjx^trnJ. . . parmx^unctiotit _toolt \U 

"Hie underline character (_) indicates where spaces muSL be placed 

llifyies to slk indicates the number of parameters that need Lo be pushed onto the slack 
to make ihe uLility call to the specified lool. 

ib^'ics/rm stk indicates the numljcr of parameters the funciLion pushes onio rhe slack. 
11ia[ many byies will be pulled from ihe stack and displayed at the end or ihe call 

parml_. . .p&rmz indtcaLes the parameters to push onio ihe stack before making Ihe 
Tool Evocator call. Parameie:^ musl be single-byle values. For example^ to enter a 
4-l3yte address, type 00 bb hh ll, where 

DC - null byte of address (space required after byie} 

bb^ bank number uf address (space required after byte) 

Aft = high byte of address (space required after byte) 

LI = low byte of address space (space required after byte, before nexi parameier) 

To entcrmulUple ASCII byles, type 'W, 'X' or "w", "x*-, using diher single or 

double quotaLion marks. Each ASCII byte is a parameter and so must 1m separated wtlh 

a space. 

Juncifan* indicates the function number to be called in the spcciHed tool. 

fiao/* indicaies ihe lool numlDcr to be called by utility rail. 

TTie function numbers ind tool numbers are listed in ihe Af^ie ilGH Toolbox 
kcfsTencer 

A lool error number is always printed along wiih parameters left on [he stack after the 
tool is called. The format af ihe error printoui is Too-l error = eeee; where eees is 
Ihe value of the accumulator (error) grter ihe lool call. On errors SOOOl-SOOOF, the U 
command removes and displays exactly Uie number of bytes it pushed onio the stack 
befyre the call. Tor errors 5-SCiOOl-. no parameters are left on the slack, an none are 
displayed- 
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Chapter 4 

Video 

Firmware 



r 



This chapter describes the routines and command sequences thai you use to control 
ihe video output of text to the Apple lies videt] .'jcreen. The AppEe IIGS video firmware 
includes routines far lexi inpui and output. 'iTiese routines are used by higii-lcvcil 
languages, but can just as eaiiily bt: called direcUy from a routine thai you have written 
using itic minJ-afl^'iembler. Almost every program on the Apple llGS lakcs inpLit frym 
the keyboard or mouse and sends output ti> dse displsy, The Monitor and BASIC 
accept keyboard input and produce screen output by using standard inpui/ouipul 

I -iviJ ■ J- 

Cf/O) sutaroullnes built into the Apple HGS rirmwarc. 
Using the video finnwafe I/O routines, you can 

□ i^ad teys individually from the keyboard 
D read an entire line of key entries 

C send characters to the rirmwarc output routintes 

□ call built-in routines that control the video display 

When you caL a routine to get an entire line, the user has the opportunily to use the 

Backspace key and olher onscreen editing facilities Ixrforc your routine ae&s the line. 
When you send characters to the firmware output routines, most of the characters are 
transmitted to the display. FEowcvor, some of ihe characters control the display 
subsys[em- These speciaE characters arc listed in Tables 4-1, 4-3, and 4-4. 



Standard I/O links 

When you call one of tlie character T/O subroutines (COUTand RDKEY), (he video 
fimiware pt^ribnns an indirect pump lo an addres-s stored in pfogrammablc memory. 
Mumory locations used for transferring control to other subroutines arc isomeiimes 
caEled vectors; in this manual, the locaLiaci^i u,wd for transferring ronirol to the I/O 
subroutines arc called I/O links. In an Apple flrjb running without a di-sk, each t/O link 
nonmlly contains the address of the body of the subroutine CCOUTl or KRYTN) thai 
Lhe firmware cal[s for Ihat spcciftc farm iiF I/O. If a disk operating systcim l-s mnnlrig, 
one or both of iliese links holds the addrcsti of the cones ponding DOS or ProLXJS I/O 
routines instead of the firmware default values. (IXiS and ProDOS maintain their own 
links to the standard I/O subroutines.) 

By calling lhe I/O subroutines thai jiimp to the link addresses instead of calling the 
standard .'subroutines direcJy, you ensure that your program will work properly with 
other software, such as DOS or a printer driver, ihai chan^^s one or botli of the VO 
links. 

For the purposes of this chapter, we shall a.ssumE: that the I/O links contain the 

addresses of the standard I/O .^subroutines: COLiTl and KJZ'^IN if [he 80-column 
ftrmwarc is disabled, and BASICOIJT (also called C3COUTD and UASICIN if ifie 
SO-column firmware is enabled. 
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Star 

The A 
keybc 

Input 
one c 

readk 

subro 
UDKB 
GHTL 

M 

RDK 

Your 
EiDKi 

tofla 
subrc 

RDKl 
the c 
curse 
that] 
next 
reclj 

KEN 

App 
KFV 
inac 
subi 
acq 

Iftb 

chei 
thei 
disj 
mo< 
indi 
cha 




standard input routines 

Tie Apple IIGS firmware indudes Lhfee different suhrnuiin^ for reading from the 
keyboard TTre&e subroutines arc wrinen lo hjnction at differenl levels. The character 
Irpjl subroutine KEYIN (or BASlClN when the 80-column nrmware is active) accepts 
one character 91 a time from the keyboard. The RDKEY subroutine (short for 
mdkej^ calls KEYIN or BASiCIN and handles the onscreen cursor. The third 
subroutine Es named fJETlN, whidi stands for get line. By making repealed calls to 
RDKEY, GETLM accepts a sequence of characiers terminated with a carriage reium. 
GETLN also provJdies onscreen editing features. 



RDKEY input subroutine 

Your program gets a tharacier from the keyboard by making a subrouiine call to 
JIDKEY SL memory locaiion $FDOC. RDKEY sets, the character ai she cursor position 
to liash and then passes control through the inpui link KSW to the curicm input 
aiibroutine, which is normally KEYTN or BASICIN. 

RDKEY produces a {iiirsof at the current cursor position, immediately to the right of 
tte characLer you last sent 10 the display (normally by using the COLTf routine), The 
Birsor displayed by RDKEY is a Hashing version of the characDer thai happens to be at 
fliai position on the screen. Usually, a user types new characters on a blank line, so the 
txjt character will normalEy be a space. "Rius, the cursor appears as a blinking 
rectangle. 



IN and BASICIN fnput subroutines 

Apple IIGS supports 40- and BO-column video displays by using input subroutines 
KEVIN and UASICIN. The KEYIN subroutine is used when the SO-co!umn lirmwafc is 
ioaetive; BASICLN is used when the SO-column Ormwaie is aciive "Wlien r-alled, the 
abfoutinc wails until the user presses a key and then returns wdi the key code in die 

jccumulator. 

If ihe 80-column firmware is inactive, KEYIN displays a cursor by storing a 
dieckerboard block in the cursor location, then storing the origina[ character, and 
then storing tlie checkerboard again_ If ihe SQ-column (Irmware is active^ BASICIN 
displays a steady inverse space (rectangle) as a cursor, in an additional operating 
mode, e-sc3pe mode, the cunsor displayed is an inverse video plus sign (+), This 
indicates that escape mode is active. See the section "Cursor Control" later in this 
chapter for more information about die escape mode. 
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Subroutine KEYIN also gcncraies a random number. While it is waiting for the user to 
press A key, KEYIN repeatedly increments the l6'bit number in metnory Iccalions 78 
and 79 (hexadecimal J'iE and S4F). This number coniinues to Increase ffom to 65535 
and then scans over again at 0. The vaiue of this number changes so rapidly that there 
is no way to predict what it ■will be after a key is pressed A program tliat reads from the 
keyboard can use this value a* a random number or as a seed for a random-number 
generator. 

When Ihe user presses a key, KEVIN accepts the character, stops displaying ihc curaor, 
and returns to the calling program with the character in the accumulator. 

Escape codes 

Subroutine KEYIN has special functions thai you invoke by typing escape ctxles at the 
keyboard. An escape code is obcaincd by pressing the Esc CHscape) key, releasing it, 
and then pressing anoiher key. Ihe key sequences, shown are noi c^ase sensitive. IhaE 
is, Esc followed by A Quppcrc&scy i$ equivalent to lisc followed by a Ooft'crcasc). 

EseajK codes are used to clear the current line, the rest of the screen, or the whole 
screeni to switch from 40-Golumn to 80-column mode and vict versa; snd to rnove the 
cursor on the screen. The escape codes that KEVIN follows ate listed in Tabk! ^I-T 

Cursor control 

The AppSe lies is equipped with four arrow keys. However, these keys dn not perform 
oifsor- movement functions unless the sfystem is specifically told to give ihem such 
funcibons. The Apple IIGs firmware provides what is called the escaffS mo<ie, which 
activates the arrow keys for cursor moves. One of eight possible escape sequence.^ can 
liC used to activate the escape mode. As Table 4-1 shows, you can enier escape mode 
by pressing Esc foLowcd by an alphabetic key or by pressing, Ksc followed by one of the 
four arrow keys. Recall also tfiai when the 80-column nrmwarc is active, the cursor 
display changes to a plus sign (+D when ihe system is operating in escape mode. 

You can continue to use the arrow keys to move around on the screen. As noted in the 
table, escape mode terminates when an>ihing other than an arrow key is pressed. 
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Escape codes and thefr runettons 



Etc;v«cod« 



Function 



Curior ccritiol 
Esc A 

EscB 

ESCC 

ESCD 

Cuiior confiol/ 

Hitering escape mode 

EscI 

tor tisc Up Arrow) 

EscJ 
t Cor ?SQ Lefl Arrow) 

EscK 

Tor Esc Righi Arrow) 

Cor Esc Down Arrow) 
scr«in/iin« cl«afdng 

tscE 

r- EscF 

Scrstn rormai control 
Ek4 



Esc 9 

Esc-Con:rol-D 

Esc-ConLrol'E 
rsc-Conuol-Q 



Moves cursor right one space; exlls from escape mode 
Moves cursor left one spaoCj exits from escape mode 
Moves cursor down one line; exits from escape mode 
Moves cursor up one line; gkIis from escape mode 

Moves Cursor up qne line and remain? in escape mode 
Moves cursoj- lefl one space and remains in ascape mode 
Moves cursor riglit one space and icm^ns in escape mode 
Moves Cursor down one line and remains in escape mode 

Clea:^ window and moves cursor to its home position 
Cuppcr-lcfl corner of screen)' exits from escape mode 

Clears to end of line; exits from escape mode 

Clears to boUom of window; exits from escape mode 

SwitdKS from BO-column display to 40-column display ilT 
SO-column Pirmware is acUve, sel^ links to BASICTN and 
BASICOUT, restores normal window siac; exits from, escape 
mode 

Switches from 40-coJumn display !o 80-column display by 
enabling Sfl-colamn firmware, ;Wis links to BASICIN and 
BASICOUT, resCQiES normal window siJte; exits from escape 
mode 

Disables control characters^ only carriage returns, line 
feeds, bells, and backspaces hive effects when printing is 
performed 

Reactivates control characters 

ff 80-column Hrmware i^ acLivc, deactivates SO-column 
firmware, ^is links to KEYIN and GQUTl, restores normal 
window siiC, exits from escape mode 

Standard Input routines 



73 



GETLN Input subroutine 

Programs often need strings of charaaera as input. Although you can call RDKEY 
repeatedly lo get several chafacters from the keyboard, there is 3 more powerful 
subfoutiftc you can use to get an ediied line of characters. This routine is named 
CE'IV^', which stands For get line; GETLN siarxs at tpcaiian 5FE>6a. Using repeated calls 
to RDKEY, GETUV accepts characters from the standard input subrnutlne — usualty 
KEYIN — and puts them into the input buffer located in the memory page from S200 to 
52FF. GETIJ^ also provides the user with onscreen editing and control features, "lliese 
are described in the next section, Editing With GETLN " 

GETLN displays a prompitng characier, called a prompt- The prompt indicates lo the 
user that the progrtm is waiting for input, Different programs use different prompt 
characters to help remind the user which program is. requesting inpui. For example, 
an INPUT statement in a BASIC program displays a question mark (?) a^ a prompt. 
The prompt characters used by Apple IIGS progratns are shown In Table 4-2. 

GETLN uses Lhe character stored at locatipn 51 Qiexadedmai S33) as the prompt 
character. In an assembly-language program, you can change the prompt lo any 
character that you wish. In BASIC or In the Monitor, changing the prompt charaaer 
ha.5 no effecl because both BASIC and the Monitor restore the prompt to their original 
choices each lime ihey request user input. 

Tablo 4-2 

Promp't characters 



Prompt 
character 



Program raquatHng Input 



7 
> 



User's BASIC program (INPUT statement) 

Applesoft BASIC 

Integer BASIC 

Monitor 

Mini-assembler 



As you type an input character string, GETLN sends each character to the standard 
output routine, normally COUTl, which displays the character at the previous cursor 
position and puts the cursor at the next available position on tlie display, usually 
immediately to the rifiht of the original pt)5ition. As the cursor iraveLi acrtjss lhe 
display, it indicates the position where the next character will be displayed 

GETLN stores the characters in its buffer, starting at m-emory location 5200 and using 
the X register to index the bufTer. GETLN continues to accept and display characters 
until you press Return. Then tt clears the remainder of the line the cursor is on, i^iores 
the carriage return code in the buffer, sends the carnage return code to the display, 
and returns Lo the calling program. 
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Ttw mauiimum Itne Icngih uhai GETLN can handle i& 255 characters. If ihe user types 
more than 255 chaiaders, GETLN sends 3 backflash C\) and a carriage return to Ihe 
dL!p[av, cancels the line ii has accepted so far, and starts over To warn ihe user ihat 
the line is gaUng full, GETLN ^cunds a bell Ctone) ai every keypress after the lAB^. 

Ecfifing with OETIN 

llie subroutine GETE,N provides the standard onscreen editing fearures used with 
HASIQ inierpreters and the Monitor Any program iha[ uses GETLN For reading ihe 
keyboard oflefs these Teatures. Fgr an iniroducdon lo odiling with GETLN, refer to ihe 
Applesojl Tumriai 

Caneal (In*: Any time you are ryping a line, pressing Conliol-X causes GETLN to 

iia;icel the line. GETLN displays a badtslarfh (\) and issues a carriage return and dicn 
displays the prompt and waits for you lo type a new tine. GETLN automatically cancels 
the line when you type more than 255 characters, as described earlier. 

Kockspoce: When you press the Backspace key, the Back Arrow key C*-), or ihe Delete 
bj.', GITlliN moves its buffer pointer back one space, deleting the las[ character in it? 
bufTcr. Ii also sends a backspace character to the rtiuiine COUT, which moves the 
display position back one space. If you type another charaaef now^ il will replace the 
character you backspaced over, both on Lbe display and in the tine buffer. Each time 
yoy press the Backspace key, the cursor moves left and deletes another character until 
you reach ihe beginning of the line. If you ihen press Backspace one more linie, you 
cancel the line. If the line is canceled this way, GETLN issues a carriage return and 
displays the prompt, 

■RQlyp*; "[Tie function of the Retype key (-*> is complemeniary to the function of the 
Bactfspicc key. WTien you press Retype, GETLN picks up the characler at the display 
pfisiiion just as if it had been typed on ihe keyboard. You can use this procedure to 
pick up characters thai you have just deleted by backspacing across them. You can use 
Ltie backspace and retyjx^ funcitons with the cursor-motion funaions to edit data on 
ihe display. For more information about cursor motion, sec the sedion "Cursor 
Control" earlier in this chapter. 



Keyboard Input bufferfng 

In versions of liie Apple II prior to [he Apple TIGS, if a user pressed a key whOe a 
program was processing the previous keysiroke. characiers that the user was typing into 
the program were in danger of beirtg lost. The Apple IlGS allows you to use keyboanj 
input bLiffering to prevent [he loss of keystrokes. 

The user can wlect keyboard input buffering through the Comrol Panel program. IF the 
EvenL Manager is enabled, the type-ahead buffer tan process an unlimited number of 
key presses. 



Standard Inptit routines 
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standard output routines 

The Monitor firmware output rpyiine is named COUT" (pronounced C-omO, which 

stands for character d}41. The COlJT routine normally calls COUTl, which sends one 
characcer lo the display, advances Lhe cursor position, land scrolls [he display when 
necessary. The COLTTl roufine restricis its use of lhe display lo an aciive area called 
the lexi window, described Ister in Lhis chapter. 

BA5TCOUT is used instead of COUTl when the SO-column ftrmwafe is active. 
Subroutine BASICOLIT \& esseniially the .same as COUTl: BASICOUT displays lhe 
character in the accumulator on the display screen at the current cursor position and 
advances the cur.^or. When BASICQUT reuirns control to lhe calling program, aU 
registers are intact 



COUT and BASICOUT subroutines 

\Phcn you call COUT (or BASlCOUTl and send a character to COUTl, the character is 
displayed at the curren[ cursor position, replacing whatever was there. COL'TI then 
advances, the oiraor position one space to the right. If the cursor position is at the right 
edge of the window, COUTl moves the cursor to the leftmost posilion on the next line 
down. If this moves the cuRor past the end of the last line in the window, COUTl 
scrolls the display up one line and sets the cursor position at the left end of Lhe new 
bottom line. 

The Cursor position is controlled by the values in memory locations 36 and 37 
(hexadecimal iZ'f and SZ5)- Subroutine COUTl does not display a cursor, but the 
input routines COUTl and C3COUT1, described in the nest section, do display and 
uie a Cursor. If another routine displays a cursor, that routine will not necessarily put 
the character in the cursor position used by COUTl. 

Control chorcscfers with COUTl and C3COUT7 

Subroutine COUTl £s Lhe entry point that is active for character output in 40-column 
mode. Emry point C3COUT1 is active when the system is in SO-eolumn mode, 
Subroutines. COIJTI and C^COUTl do not display control characters. Instead, the 
control characters listed in Tables ^-3 and 4-4 are used to initiate action by the 
firmware. Other control characters are ignored. jMost of Lhe funcUons listed here can 
also be invoked from the keyboard, either by typing [he control character listed or by 

using the appropriate escape code, as described in the section 'Escape Codes' eariier 
in this chapter. 
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^^^±^S' 4-3 


1 


1 


^1 Control chofacters with B0-co5umn firmware off 


1 


^H Control charactar 


Acrion UM*T\ by coiiTJ 


^M ConEral'G 


Produrr-i user-defined tone (Conlrol Panel menu} 


^M Coibtrol-H 


Causes backspace 


1 


^m Conirot-J 


Causes line feed 


1 


^B ContfoI'M 


Causes carriage reLurn ^m 


II 


^B ConUcil'A { char] 


F'lrsi character output after Conuol-'^ becomej; new cursor. If ^| 
Delete key i$ first character, default prompt is rcstofcd. H 


1 


H Tid}le4-4 


■ 


1 


^1 Control characters with BD-column tirmwore on H 


1 


^1 Conlrol characltr 


Acrion tQkvn by C3C0UT] | 


^m ConLTol'Ii 


Turns cursor off jH 


^1 Conlrol-F 


Turns cursor on ^M 


H 


^m Control- G 


Produces user-defined tone CControl Panel menu) ^B 


H 


^B Csnirol-H 


Causes backspace ^M 


H 


^P Conuol-J 


Causes line Teed ^M 


H 


^B ConUDl-K 


Clears from cursor position to end of screen ^M 


H 


H Conifol-L 


CSMSSS fofffj fggd H 


1 


^m Ccinual-M 


Causes carriage reium ^M 


1 


^B CDntml-N 


Changes to normal display format ^M 


H 


^M Cpnirol-O 


Changes to inverse display format ^M 


H 


^H CciDtfDl-Q 


Sets ^0-column display ^M 


H 


^1 CDJitrol-R 


Sets SO-column display ^M 


H 


^m Contrcil-S 


Stops listing of characters untU another key is pressed ^| 


1 


^1 CQiiirol-U 


Deactivates enhanced video firm^-are H 


H 


H Ojntrol-V 


Scrolls display down one line, leaving cursor in current position ^M 


H 


H Coniiol-W 


^QSQlh display up gne Ime^ leaving cursor in cuneni position H 


1 


^1 Cortiol-X 


Disables MouseTcxt character display and uses inverse ^M 
upper^se characters H 


1 


H Corirol-Y 


Homes cursor to upper-left corner H 


H 


H Control-Z 


Clears line on which curs-or resides ^B 


H 


^B Conirol-l 


Enables MouseText character display by mapping inverse ^M 
uppercase characiert to MouseText characters ^M 


1 


^1 ConiioU\ 


Woi'es cursor position one space lo rights from edge of window, ^M 
moveg ID left er^d of next iine 1^ 


1 


^1 Control'] 


Clears from cursor position to righl end of line 


■ 


^M Control-. 


Move5 ozrsor up one line with no scroti 


iH 


^B Ccmtrol-p^ 


Goes to XY; using nexi ;wo characters minus 52 as 1-bytc X and Y 


1 




values, moves cursor to CH=X. CV=Y (Pascal) 


^M COfdUrol-A [char] 


First character ouiiput after Contrql-A becomes new cursor, [f 
Delete key is first character, default prompt is restOfCd. This 
works only when using B;\S[C links, not Pascal output links. 

Stor^dard output routlr>es 77 

1 


^H 





Inverse and (lashing text 

Subrcmiine COUTl an display text in normal format, inve.Re Format, or with some 
resLricLJons flashing format. "Hie display formal far any tharatier in ihe display 
depends on \-wo factors: the character set currently being used and the setting of the 
two high-order bits of [he charaaer's byte in the display memory, 

As it sends your text diaracters to ihe display, COUTl 5eis [he high-order bits 
according to Lhe value stored at memory locaLJon 30 (liexadccimat S32), If ihai valug is 
255 Oiexadt!cima[ SFF^, COUTl sels lhe character display to norma) format, if that 
value is Gi (hexadecimal S3F), COLTl seLs the character display lo inverae format. If 
the value is 127 Qiexadecimal $710 and if you have selected tlic primary cliaracler set, 
the tharacLcrs will be displayed in flashinfi formar. N'oce that the flashing format is not 
available in the altert^ate character set. Table ^-5 shows the effect of the mask value on 
partiojiar parts of lhe character set, 

Table 4- a 

Text format coritro! values 



Ma Ik 
<dec) 



VaiuB 



DidplDy lormat 



255 

127 
63 



SFF 
$7F 
53F 



Normal, uppercase, and lowercaisc 
rla^hing, uppercase, and symbols 
Inverse, uppercase, and lowercase 



To control the display fomial of lhe characters, routine COlTTl uses (he value at 
location 50 as a logical mask Lo force the setting of the two high-order biL5 of each 
character byte ii puL-j. into the display page. It does this by pcrformins a logical AND 
npcration on Lhe data byte and mask b>'te. The resuking byte contains a in any bii 
that was a in the mask, BASICOUT, used when tlie SO^column firmware is active, 
changes only the high-order data biu 

^ i\'ote: If lhe 80-ccilumn Hnnware is inactive and you store a mask ^Tilue at location 50 
with zeros in its low-order biLS, COUTl will mask those bits in your tcxt_ A> a result, 
some cliaraciers wit] be transformed into other charaaers. You should set lhe mask 
values only to those given in Table AS. 

If you set the mask value at Icftaiion 50 to 127 Chexadecimal STIO, the high-order bit of 
each resuliing byle will be and the characters will be displayed either as lowercase or 
flashing, di!pcndicig on which character set you selected. In the primary character set, 
tfie next-highest bit, bit 6, selecij; flashing formal with uppercase character. With the 

primary character set, you can display lowercase characters in normal format and 
uppercase character* in normal, inverse, and Hashing formats. In thtr alternate 
character set, bit 6 selects lowercastr or special charaaers. With the alternate character 
set, you can display uppercase and lowercase eharac^er^ in normal and inverse 
formats. 
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Ofher firmware I/O routines 

In addifion to ihe read and write character romines described abovt, Lhe Apple TIGS 
fimiware also includes several rouLines that provide c[)nvenjen[ screen-oriented I/O 
fuficLitinS- These functions arc Hated in Table 4-6 and ane described in detail in 
Appendix C, "Firmware Entry Foinls in Bank SOO," 



Imporfanf 

Appendix C b the offlciaS list of all entry poln^ thot ore currently valid ond for 
v^ch contlrtuad support will be provtded In future revisions of this product, 



Partial tist of other Monitor Ann ware I/O routlries 



Lecatton 



Nam« 



SFC9C 
IFC9E 

tFC42 

SFeje 

SFDED 

SFDFO 
$FDgE 
$FDSIi 
SFD6A 

SFeip 

SFC5S 

5FD1B 

*F900 
$F94A 

SFDDA 
SFDE3 

SFDQC 

$F371 
SF86'i 
SFC24 
SFa23 



Dvicrlptlan 



CLREOL 
CLEOh?, 

CLHEOP 

CI.RSCR 
CLRTOP 
COLT 

COUTl 
CROUT 
CROUTl 

GFTLN 

HUNE 
HOME 

KEYIN 

PLOT 

PSBL2 

PRBYTE 

PSMEX 

PRNTAX 

KDKEY 

SCRN 

5ETCOL 

VTABZ 
VLINE 



Clears to end of line from curreni ciJrsor position 

Clears to end of line usinjj contents of Y register as cursor 

pOa i lit.] n 

Clears to bottom of window 

Clears low-resolkJtion screen 

Clears Eop 40 lines of low-resolution screen 

Calls MLitpui routine whose address is stored in CSW 

CnormalV COUTl) 

Displays character on screen 

Generates carriage reiurn 

Clears ttj end of line and ihcn ger>er3te5 carriage return 

Displays prompt characiet; accepts sirifig of characters by 

means of KDKEY 

Draws hordzonial line of blocks 

Clears window and puts cursor in upper-lcfl corner of 

■windcjw 

With 80'COlumn firmware inactive, displays checkerboajxl 

cursor; accept characiers from keyboard 

Ploti single low-resolution block on screen 

Sends I to 256 blank spaces to ouiput devits; 

Prinis hexadecimal byte 

Prints A bits as hexadccima! number 

Prints conients of A and X in haxadecimal Format 

Displays blinking cursor; goes to standard inpul routine 

Cnormally KEVIN or BASICIN) 

Readls color of low- resolution block 

Sets color for plotting in low-resolution block 

Sets cursor vertical position 

Draws vertical line of iow-resolution blocks 

Ofher flrmware I/O routines 
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The text window 

After starling ihe compuief or af[er 9 reset operalion^ the firmware use5 ihe enllre 
display for text Hywever, you can restrict icxt video activiiy to any reciangular 

portion of [he display that you wish. The active portion of Lhe display 15 called the texi 
window. COUTl (or BASICOTJD puts charaoers imo the window only; whqn i\ 
reaches, [he end of the lisl line in the window, it scroll on3y the contents of the 
window. 

You Can control the amoiint of the screen that the video firmware reserves for text by 
modifying memoiy directly, You can set the top, bottom, Icfi side, and width of Lhe 
text window by storing the appropriate vaiues in four locations in memory. TliLs allows 
your programs to conirol the placement of text in the display and Lo protect other 
portions cuf the screen from being overwritten by new texL 

Memory location 32 (heKadecimal S20) contains the number of the leftmost column 
in the tcjtt window. This number normally is 0. the number of the leftmost column of 
the display. In a ^0-column display, the maximum A.-alue for ihls number ij; 39 

(hcxadedmai $27); in an SO-columi^ display, the maximum value is 79 QiexadedmaJ 

Memory locadon 33 (hejcadecimal i2]) holds the width of the text window. For a 40- 
column display, the width normally is 40 Chexadecimal 528); for an eO-column 
display, Jl normally is 30 (hesadecimal $50). 

Memory location 34 (hejcadecimal $22> contains the number of the top line of the text 
window. This normally is 0, the topmost line in the display, lis maximum value is 23 
Giexadccimal S17). 

Memory location 35 Chexadecimal $23) contains the iiumbtT of the bottom line of the 
screen. Its normal value is 24 Chexadecimal 518), the bottom line of the display. Its 
minimum value is ]. 

After you have changed the text window boundaries, the appearance of the screen will 
not change until you send Lhe next character to the screen. 
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This chapter covgis ihe fealures of ibe serial communicaliDiis firmwaie. The 
Apple IIGS serial-port nrmwaro prenvides serial communications for external devices, 
Such as printers and modems. The Apple tiGS scria3-pojt fii-mware uses a iwo-chanitel 
ZilDg Serial CommunicaUons Conirotler chip (SCC8530> and RS422 drivers. The 
driver firmware emulates the functionality of iha Apple Super Serial Card CSSC) and 
supporLi inpui/oulpul buffefing as well as background printing. The rmnware also 
implements a number of calls [hat ihe application can make lo control the new 
features, 

Inpui/ompm buffering and background printing are done on an interrupt basis and 
can use any bufTer size up tp 6'^K at any location that the application wishes. I/O 
Ixiflering is transparent for BASIC and Pascal, An applicaijon can make a function call 
tliai starts background prtniing. The function czll copies ihe data into the background 
printing buffer and iheri returns control to the application. Data is fed to the printer 
automatically until the entire conlenis of ihe buffer have been sent to the printer 

Note that AppleTalk, when active, requires ihe use of one of the two available serial 
channeb. Therefore, only two of ±cse three — AppleTalk, serial port 1, and serial 
port 2 — are allowed tci tw active at any one time, The Control Panel program ensures 
Ihat at least one serial port is made inactive when AppleTalk has been selected You 
can't initiall^o the serial-pon firmware when the channel is Ijeingused by AppJeTalk, 
Botli pm 1 and port 2 can be configured a* eilber printer or communications 
(modem) ports. 

You can set cEefault parameters for the seriaE porLs through the Control Panel firmware. 
The application program can temporarily diange ihe pararoeter vaJues by sending 
control sequences to the serial-ppn firmware. 
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Compotibifity 

The commands used to tommunicaie with the serial-port firmware are essentially the 
same as those used with the SSC However, many existing programs using these pons 
are not compatible with the Apple IIG5. Many programs, particularly 
communications packages, send their output direcdy to the hardware; the Apple IIGS 
hardv-Tire no longer uses iiardware different from that used on the SSC. Print programs 
and applications written an BASIC and Pascal are more Ukely to work. 

One other difference between the Apple IlGS serial-port firmware and other serial- 
port firmware is in enor handling, in the SSC, as well as in the Apple Sic firmware, 
when a charaaer with an error is received, the character in onror Ls noi deleted from 
the input stream. The Apple IIGS firmware does delete the character from the input 
stream and sets a bit to record the fact thai an error was encountered. 
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Operating modes 

The serial-pon nrmwarc has three oiain operating modes: primer mode, 
communications mode, and lerminal mode. You itei (hese modes through the 
Conuol Pan«?l_ An applicaLion program can change these modes by sending 
command sequences to the seria] pon. 

^ !^ot& If you are writing software that depends on the ^Erial-pt.)n: iHinnwart! lx:ing in a 
given operating mode, make sure that your docunitntaUofi teLs the user to set up 
the firmware using the Conlrol Panel in ihe proper way. 



Printer mode 

When in primer mode, :he serial-poit nnnware can send data to a printer, a local 

lerininal, Or some ulhcr serial device. 



II 



Communicafions mod© 

Whtn in t;(jmmumcation.s mode, the firmware can operate with a modem. From 
BASIC, while the serial firmware is set for communicaLions niode^ the firmware can 
enter a special mode, callyd lerminal mode, in which the Apple IIGS acts like an 
urtirnelligcnt terminal 



Terminal mode 

In lerminal mode, the Apple llCS acis like an uninteHigeru [erminal. All the charaaei^ 
typed are passed to the serial output (except the ccsmmAnd string), and all serial Input 
goes directly lo the screen. 

You enter terminal mode from ihc BASIC interface by typing iN#n and then typing 
the Current command character fnllowed by a T, The prompt character changes to a 
(lashing underline (_), indicating that terminal mode is active. You exit terminaJ 
mode by typing the current command charaaer followed by a Q, 

You can use terminal mode with buffering enabled, "Wm minimizes <Jiafa[:ter loss at 
higher baud ratts. Enable buffering witJi tlic BufTering Enable (BE) serial conimandK 
described below. 

M^ny remote computers send a line feed C-F) after a C3rriag,e return (CR). When using 
terminal mode with sucli a computer, u^ die Masking Enable (ME) serial control 
command to mask any line feeds that immediately follow carriage returns. 



Operating modes 
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Handshaking 

Communicalions-equtpment manufacturers have devised a variety of handshaking 
schemes Apple riGS accymjiiodaies ihese various schemes by providiflg, several 
hardware and software handshaking options. 



Hordworep DTR and DSR 

"W^ien the DTR/DSR option is active, the data lerminal ready (DTR) and dala set ready 
CDSIO lines control the data How imn and out of the system. The Apple IIGB Uan.*mit5 
characters onJy when Lhe DSR line is enabled, the DTR line tells the device when the 
host is ready to accept data. Th^ defauU Comral Panel setting enables hardware 
handshaking. If this opiion is disabled, the DSR line is not checked on transmission 
and the Dili line v^-ill not be toggled during reception (see Figures 5-1 and 5-2). The 
target device's firmware determines whether these lines mean anything during data 
transfer. 

The data carrier detect (DCD) line controls modem eomiiiLjnicstioils. If you enable 
the DCD handshake option,, the Apple IIGS serial-port llrmwarc will transmit 
characters onJy when the DCD line i^ enabled The DCD opiion has no direct cfiect 
on character reception. This mode provides compaiibiiiiy wiih the SSC, which uses 
DCD as a handshake line. 



App(0llGS 


Tx 






Tk 


»- 




Modem 
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FEguroS-l 

Horndshdklng when DTR/DSf? option Is turned on 
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Tx 



PSR 



Remote 
compuTftt 



FIguiv S~2 

Kandshakinrg when DTPyDS^ opion is turned off 



Software, XON and XOFF 

If an XOFF d 13) cha/acter is received from a device attached to the SCC, the firmware 
hal^ character transmission umil an XON <5ll) diaracier is received. TliL'; npiion 
works in addition to ihe hardware handshake, in printer mode, the firmware di^iablcs 
ihis function. 
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Handshaking via XOI^/XO 
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Handshaking 
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Operating commands 

Apple IIGS control comniands, embedded in ihe serial output flow, are invoked by 
BASIC or Pascal output routines, For each of iht operating modes (printer or 
communications^, you can conirol many aspects of your data transmissions, such as 
baud rate, data format, and line-feed generaUon, by sending control codes as 
commands irj the firmware. All commands are preceded by a command character 
and optionally followed by a return character CJOD). 'llie carriage return is aUowed to 
maintain compatibility with the SSC. The format of ihe commands is as follows; 

[ coitttnand-chaTaciert i tzammaruJ-siring [ tlelum 

The ctimmand character usually is Control-I in printer mode and Conirol-A in 
communicationji and Lcrminal modes. In ihe examples in the following text, 
Conirot-I is used unless the command being dcstrilied 15 available onfy in 
communications mode or terminal mrxle, A retuirn character is represented by its 

ASCTI symbol, CR. 

Thete are three types of command formatsi 

D a number, Eepresented by n, followed by an uppercase letter with no space between 
the characters Cfar example, 4D to set data format 4^ 

n an uppercase letter by itself (for example, r to reset the serial-port firmware) 

D an uppercase letter followed by either a space or no space and then either K to 

enable or D lo disable a feature (for example, LD to disable automatic in^eiTicn 

of line-feed characters) 

The allowable range of n is given in each command descriptioti that follows. 

*^ ^-ote: All options, such as baud rale, parity, and line length, c^n be confsKured 
from the Conirol Panel (see Chajser 10, "Mouse Firmware'). 

Serial-port fcmiware must be reinitiali^^ed after changing opdona from ihe Control 
Panel for the new vaJuea to take effect 
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The command character 

Jibe nonnal cominand dharacter is Control-I (ASCII 309) in printer mode and 

iLrot-A CASClI JOI) in communicaUons mode. If you want to change the command 
liaracter from ControlU lo another ccmmand character (for example, Control-W), 
send Control'W to Control-I. To change back, send CuniroS-I lo ConLrol-W. No 

Mum Eharaaer js required afEer cKher of tliese commands. 

H A'ow. The SSG allows you lo send ihe current commajid character through ihe 
output atrcam by sending the character iw'icc In a njw, The Apple tlCS does not 
allaw Lhis-i ihe character will noi be ouiput. To send the comniand character 
Lhrough the serial pon^ you must temporarily change to an altemale command 
diaracler, For example, if ihc curreni command character Is Conlrol-I and you 
want Id send a Control-I oui the serial poit, then send 

ConCrol'l Control-A Control -I Contiol-A GoDlrol't 

"JTie first two characters change the command character lo a Control-A, The third 
chaiacter is the Control-l you wanted to send. 'Ilie fourth and fif\h characters 
restore the command character to Contfol-I again. Remember, though, that you 
can disable all comma nd-characier parsing by using the Zap command- 
To generate this command character in Applesoft BASiC^ enter 
Pliih'T cj5a$(g> ; " comiTHirid-stTiTig" 
For Pascal, enter 

I3:TELN [CHRiI 9) , I command-string' ] ; 

TtK following example shows how to generate the command from a BASIC program; 
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fl5 - CHH&[9| % 
PRINT DS; "PS#i": 
PRINT AS; "6B^' ! 



REM Sends Control-D 

RSM Sands Control-J 

KEH Eatabliahes linki BftSIC to port 1 

REM Changes to 100 baud 

PE!h! Continue pcograni 



^Command strings 

, command string Ls a letter sometimes with a number prefb: and sometimes with an E 
lor a D .sufFlx. Comniand strings select the option lo be used; for instance, ihcy may 
diange the baud rate, selecl the data format, and sci the parity. Its preceding 
HtaiEplc showg commands generated In BASIC- ihe command strings in the following 
I sections are generated from t)ie keyboard. 
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Commands useful in printer and communfcciHcn« mode« 

"Ilie following commands are most useliil in primer and communicaiions modes, 

Boud rote, nB 

You can use she fiB command to select ihe baud me for ihe seria^port firmware, For 
example, tci change ihe baud rate to 135f send Conlrol-l 4B GR to the scrial-port 
Firmware (sec Table 5'1), 



TobteS-l 








Baud'fota selections 






n Baud rata 




n 


Baud rat* 


Default' 




B 


raoo 


1 50 




9 


1800 


2 75 




10 


2400 


5 no 




11 


3ffiO 


4 15^.5 




12 


^00 


5 150 




13 


7200 


6 300 




14 


5600 


7 600 




15 


1^,200 


' You set the derauk 


bv 


using 


ihe OonEfol 


Panel. 









DortaformoLnD 

You can override the Conifol Panel seLting thai specifies ibe data format b^ using the 
nD command. Table 5-2 shows how many data biLs and slop bits correspond lo each 
value of n For example, Conirol-I 2D makes ihe seriaUport firmware irainsmii each 
chsraaer in the form of 1 siajl bit (aEways transmitted). 6 data bits, and 1 slop biL 



To Wo 5-2 

Doto-fofmaf selections 


n bit4 


Slop 
bilE 


e 


1 


1 7 

2 6 


1 
1 


3 5 

4 S 


1 
2 


5 7 

6 6 


2 
2 


7 5 


2 
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w 
Porify, nP 


1 




Yqu can use ihe nP command to scl the pariry [hai you wanl lo use for dala 
innsmission and rccepLion. Four parity opdoas are available, These are Usled in 

Table 5-5. 


1 




ParllfV selecMons 1 


I 




n Pa rllV vatus 

1 


1 


None (default value) 1 

1 Odd 

2 \nne 

3 Even 1 
II , 




1 * MJte; The sec 8530 does not support MARK and SPACE pariiy. 


I 




Line {engtti« nN 


I 




The line length is set by .-ientling CorHioM nN- The number n can be in ihe lanj^ of 1 
10 255 charaaers. For example, if you send ConUol-t 75N, the line length i5 *et lo 75 
{Characters. imi&. Use the C command, discu^ed next, to enable line formaiting.) If 
ytjii sel n to 0, formalting is dis3.bied 


1 




i 
Enotile Une formatting, CE and CD | 


1 




1 A Torced camaEe return is invoked after a lineful of characiers by sending ControM 
1 CE. Far example, Contml-T 75N (see "Line Lengih" above) and Conirol-I CE cause a 
Forced carriage return after 75 ehamciers are typed on a line. 


^H 




Hondshoking prolocol, XE and XD 


^^H 




1 Sending Control-I XE CR or Coniiol-I XD CR lo [he serial port firmware determines 

whether the firmware looks Tor any XOFF CS13) characlcr coming from a device 1 
, SElached lo Lhe SCC. Ii responds by halting iransmission of characle^B until the ^rial- 
j port firmware receives an XON CSll) character frqm Ihe device, signaling ihe SCC lo 
; continue transmission, fn printer mode, ihis function normally is disabled, 


1 




XE =- Dried XOi-T. awali XON. 
XD = Igtiore XOFF. 


^^H 
^^H 

^^^H 
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KeybOCrfd inpuf, FE cmqf FD 

The b'D command is- used lo make the sertal-port firmware ignore ke^-board input For 
ejtampSe, you can include Control-1 FD CR in a program, followed by a routine that 
reErieves data through the seriai-pori firmwarie. followed by Control-I FE CR Eo turn [he 
keyboard back on_ As a default, the serial-port rirmware keyboard input is enabled 

FE = Insert keysLrokes inlo Aerial-poTt Finmivare input aJrcair- 
FD = Disable k^?ybQard Enpyt. 

Automatic line feed, LE and LD 

The auldmadc line-feed command causes the serial-port firmware to generate and 
transmit a line-feed character after each return character. For example, Control-I LE 
CR [o pnnl iisUngs or double-spaced lexL 

LE - Sdcl l[ne feeds dfter each carriage return output. 
LD - Do not atld ]inc fwdls ^fler carriage return output, 

Reset Ihe seriol-port nrmwQr^, R 

'iTie B command resets the serial'port Unrnvarc,, cancels all previous commands to the 
serjal'port firmware and reinstaUs the Control Panel default settings. Sending 
Control-I K CH to the serial-port Hrmv^'are has the same effeci as sending PR^ and N*0 
10 a BASIC program and then reseuing the serial-pod firmware, This calJ also 
relinquishes any memory obtained from the Memory Manager for buffering purposes. 



c 



r 
a 



Syppresj control chorocters, Z 

The Z command causes all further commands lo be igno.red This command is useful 
when the data you are transmitting (for instance, graptiics dataD contains bit patterns 
ihal the serial-port firmware could mistake for control characters. 

Sending Control-I Z CR lo thie serial-port firmware prevents the firmware from 
recognising any further control characters, whether from the keyboard or contained 
in a. strea.m of characters sent to the seriahporl firmware. All tabbing and line 
formatting are disabled after a Control-I Z command 



Imporlant 

^^© only wny lo r-einjtote cornmand recognJtion otter the Z comnnoncl Is eitber to 
Initialize the sertal-port flrmwar© or to use tb© SetModeSlts coll described tater In 
this chapter. 
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Commands useful in communicottons mode 

T1i$ followiiig commands lare mosL useful in conimufiicaliofis mode. 

Echo chorocters to the screen, EE and ED 

Ttie EE and ED commands are used to display (echo) or not la display a dharaclef on 
the video screen during communicalion. For example^ if you send Controt-A ED CR, 
iJk senat-port firmware disables liie forwarding of incoming characters to the screen. 
TMs command can be used lo hide a password entered n a lenminal or ;o avoid ihe 
double display of charactera. 

GE - Ecbo input. 

ED - Lton't echo tnpuL 

McQk line feed in, ME and MD 

If you send Contirol-A ME to the serial-pott rirm'waire, tlie finrvware will ignore any 
incoming Line-feed characier that immediately Follows a return character. 

Ir>put buffenng, BE and BD 

The BE and BD commands control input and output communication buffering. 

TermlnoJ nnode. T ond Q 

The T ■command uansfers you to terminal mode. In this mode, you can communicaio 

wiih another computer or a computer time-sharing service. Terminal mode is enlered 
through Ihe BASIC interface, This means thai you must initialize the ftrrawaic by 
typing iN+n and then sending Control-AT. 

♦ .\'oie: IN*n sets the port input link, aod PR#n sets the pon output link. The 

lowercase n Indicates the pprt number. 

To quit lerminaJ mode, send Conlrol-AQ. 

Often, when communicating with another computer in terminal mode, you want to 
send a break character to signal the other computer that you wish to signal the end of 
the current segment of transmission. To send a. break character, send Control-AS CR. 
"Iliis command causes the serial hardware to transmit a 253-miLisecond break signal, 
recpgniaed by most time sharing systerns as a sign-off signal. 



Oparotlng cornrnonds 
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Table S-4 summariifes Krminal-mode command characters. 



ImpoMant 

If you. enter terminal m&de and can't s&s what you typs echoed on the vSdeo 
screen, the modem link may not yat be estoblistied or you nncv need to ise the 
Echo Enable commancf (Control-A ££)► 



TabI* 5-4 

TennanaF-moda command chorocters 

Charocttr DitcKptldn 



S 

T 

Q 



Transmiis ajS-millisecond break Ciil zeros) 
Enters terminal mode 
Exits terminal made 



Tob in BASIC, AE and AD 

Tf you send Control-I AE CR to Lhe serial-port firmware, the BASIC hori^onul poeiUoa 
ctjunitir is left equal to ihe column count. Tabbing iniiJaJly is disabled. ]t is up to the 
program to enable this feature if tabbing is desired, 

AE - Implcraenl BASIC Labs. 

AD " Do aA Iraplemsnl: BASIC tabs. 



Programming with serial-port firmware 

The serial-port firmware provides Ewo ijijerfaces; one for BASIC and one that adheres 

to the Pascal 1.1 finnware protocol. 

*& Xole: To use [he serial-pon, rirrnware, you must set tlie 65Bl6 data bank re^ster to 
$00, £hif[ to emulation mfHJq (e bit sel to 1), and then issue your caL. All entry 
points are in the SCnOQ space in bank 500. (This applies to all calls to serial-port 
rirmwarc,) 



92 



Chapters: Serlal-PorJ' Firmware 



BAStC Interface 



II 



The following entry points accommodaie the BASIC interface (n is the slo[ number, 

■which cafi be 1 or 2): 

CnOO BASIC in iLLiI lz2tion (aEso outputs character Ln the accumulator] 

lCn05 BASIC rc^d thSracUT (d^ariaef tet^sfEit;d 10 atojmtjJstor; X, Y preserved) 

iCnUl BASJC write character ^character pasied through arcvmulalorj X, Y prcwrvtd) 

Although the call to SCNQO coiiicidentally outpuLs the characier in the acoimulacor, 
you should, not U5e ihis 5i<ie elTect as (he staJidLard mesns of character output. Raihef. 
you should use the SCNO? entry point for oulpul of aW but the first character (thai is, 

initialize ihe serial port only once), 

Wicn you type lN#n or PRfln Cset input or output link), BASIC makes a calJ to 
iCnOO ariSJ- !L sets either the KSWL or CS'ttI- link lo $CnOO. When the ^serial-port 

imnwarc has co:ntro!, it alters the links so that they point to the firmware Read and 
^rite routines. 



Pascof protocol for assembly language 

[fyou are a machine-language programmer, you should jse the Pascal 1.1 pcolocol Co 
■CDmmunicate with the serial-port firmware. The Pascal 1.1 protocol inlerface is more 
fleidblc ilian ilic BASIC protc»col. The Pascal l.I proiocol tises a branch tabic in the 
SClUO page to indicate where each of the service routines begins (see Table 5-3X 

For example, to reach the Read routine, nead the value contained in location SCnOE 
{siippoae it is Sis) and ilien execute a JSR in.yuucLion in the address Cfor example. 
SCntS). Table 5-6 lists the I/O routine offsets and registers. 

t Note.- The. Pascal interface assumes that the application supplies a line feed after a 
carriage recyrn, overriding ihe Control Panel selling. If the application does not 
supply' line feeds, it should send Lhc U: Gine feed gcneraiiort) call descrilxd in the 
section "Command Strings' earlier in this chapter. 



Tabie 5-5 

Ser^'ice roulnin© descrlpHoris and address offsets 



Eoulirw naiTiB 



AddFeii 



[>e(cr>lption 



I 



Initiahzation 

[lead 
Wriie 

^tLl£ 

Contiol 



$CnOD 

SCnOE 

JCnOF 

SCnIO 

SCnlZ 



Resel port, rcslote Conijol Panel dcfaulis 

Wail Tor and get next character 

Send character 

Inquire if character has been received 

Access extended interface commands 



Programming with se'rJal-port firmware 
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Table S-6 

I/O rourins offsets and registers for Pascal 1.1 flrrrftvate protocol 



Addieu 

offset 


Wh«n used 


X register 




V regj(t4r 


A reglsfer 


SCnOD 


InitializatiDn 
On entry 
On exii 


Sc:n 

Error code 




SnO 
Undefined 


Undefined 


$CnOE 


Read 
On enlry 
On exit 


iCn 
Error code 




SnO 
Undefined 


Character read 


SCnOF 


Write 
On entry 
On ewii 


SCn 

Error code 




SnO 
Undefined 


Character to write 
Undefined 


SCn 10 


Status 
On entry 
On exi[ 


$Cn 
Error code 




inO 

Undefined 


Request (0 or IJ* 
Undefined 


Ex!«r^ded 
Inl&^lacof 

5Cnl2 


Control 
On entry 
On exit 


Commanci \i&\ 

address Ca.lS) 
Undefined 


Command list 
address (16.. 233 
Undefmed 


Command list 
address (0.7) 
Undefined 



■ ItequeSi code means A tv you ready to accept outjfut? Liequest code 1 means Do you 

Carry - means nc*,- Carry - 1 meam yes. 

t If the funclion call returns wjih the carry bit set, an error is reiurrwd In the accumulator. Tlie 
status call can returft a 'bsid request code" CSIOi- Result codes retucncd hy the extended 
jnierracc aj€ a£ rollowj; 



Etrortypa 

No error 

Bad call Error 

Bad par&mcier count 



t*.phanat|iw 



SQOOO 



No problem detects. 

Illegal command used, 500OI 

Parameter count not cornlstenl with command requested. 50003 
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Error handling 

V?hen the serial-port rinmwafe receives a eharacler from the hardware, it checlis ihe 
HTor status KJgistcr ini Ihe SCC. If Lhe character has a framing or parity error (assuming 
diM ihe parity option is not set to None), the charader is deleied from the input 
sffHm and tbe appropriate bii-mode bit is set. You can use the GetModeBiis call to 
read these two bits (one for framing errors and the other for parity errors) to 
deteimlne whether at Eeast one receive crrqr has occurred- After you read these bits, 
you should dear iheJTi (using SeLfilodeBits) so that future enors can be detected Krror 
checks should be perfomied periodically so that you will know whether received data is 
icojratc. 






Buffering 

Input and outpyt communications and bacl^ground printing can be transparently 
tufTered. Izach port has two buffers: one Tor inpul and one for output. Default buffer.^ 
ue 20-48 dtaracters each. If you wish to use a buffer larger than this,, you must pass the 
iddress and length lo the firmware by way of the extended-tnlerface instruction 
MnBuffer or SetOucBuffer, You can allocate up to 64K byte*. 

* M?fe In systems with liule RAM remaining, you can reduce the si^e of the I/O 
btifferj to 128 bytes. 

you can enable buflering by using the PH#n command from BASIC if the buffering 

cption has been set in the Control Panel. If ihe bufiering option has nol been sei, you 
can still enab!e buffering from ihii keyboaid or by sending the BE command through 
the output flow. When buffering is enabled for output, character^ sent to ihe firmware 
we placed in a. HVO (first in, llrst ouO queue in the output bufTer. These charaaers are 
sent out on an iniemipi basis whenever the hardware is ready to send another 
chancier. 

Tilt: XON and XOFF charaaers are not queued-, they are sent directly through ihe 
channel .so ihat the dau flow to the Apple IIGS may be stopped or restarted 
immediately. Characters received in the buffering mode ape placed in the input 
cfueue, and all read call* return characters from the queue. Any XON and XOhT 
diaraaers received are not queued, so the oui^wit flow can be halted or resumed 
Lmmediatcly upon reception, 

When the input queue becomes more than three-fourths full, the firmware attempts lo 
disable ihe handshake. The firmware sends an XOFF character (if XON/XOFF 
handshaking is enabletDn or the DTK line is disabled <if DSR/DTR handshaking is 
enabled). You can determine, through your application program, that the handshake 
has been disabled by inspecting the input flow mode bit using the (jetModeBits call in 
the extended interface. Ttie firmware: reenablas ihe hand'shake as soon as the receive 
queue fills less than one-Fourth of the input buffer 



Buffering 
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You can dctGrmifie the numbfr nf rharacfias in the Input queue nr ihe amount of space 
iGfL in the output queue by usuig (hp TnQSlatus and OuiQSiatus commands in the 
extended inierfaoc Also, iTie InQ^tatujj call rerums the amount of time i^lapsed since 
[>ie last character was queufid. This allows a prnjinm to kcf p track of the input siream 
acUviiy level even Ihough it is not invofved in the interrupt process. 

♦ Note: 'Che InQStaiiis elapsed-bme counter Functions correctly only if the heardieat 
interrupt task his been started The heanbeat intemjpt task is a set rif functions 
called by interrupt code that run automatically at one-thlrueth of a second 
inieivals. 



Interrupt notification 

When a channel has buHering cnahled, ihe firmwan^ -iervices all interrupts that occur 
on that channel. If an application wishes to service iniemjpis for a given channel 
itself, it should dlsahlf^ buffering uiiinj; ihe RD command in the ouipiit flow. If the 
bufTering mcMle is off, the serial-port Hnnware will not prnoe^.^ any intcrmpLs, The 
system interrupt handler will transfer iiorirol to the !]5er's interrupt vector as SD3FR in 
bank 300 (This is the ProDOS user* intemipt vector.) The user's inlemipt service 
handler is then completely responsible for all serial-pori firmware interrupt service. 

If ±e appSicaiion does noi wart to disable buffering, but does wish to be nolifledwhen 
a certain type of serial iniemipt occurs, ft can in.struct ihe Firmware to pass ccmtrol to 
an application-installed routine afier the ayfuem has serviced the interrupt, The 
applicai30n cells the firmware when ii wishes to be notified and establishes the address 
of the applications completion routine by using the Sctlnilnfo routine; (See 
Chapter 8, "Intemipt-FTandler Firmware," fnr more information about intemipt 
routines.) This call guaran:ees that tlie completion routine will gel control when a 
spcdfic type of interrupt occurs, but only after the serial-port firmware has processed 
and cleared the intcrrupi. The application then uses the Cednilnfo routine to 
determine which fnterrupi condition occurred. 

A terminal cmufator orTcrt a typical example of when interrupt nmificatlon might be 
desirable. The emulator usually shottld perform input and output character buffering, 
handshaking, and other such opcraiions The Ti-rmi^iat emulator can Ise designed to ' 
allow the firmware to handle all cliaracier-buffering details. The designer of the 
emulator can have the Rrmware signal the emulator program when the firmware 
receives a break character. To enable this special-condition notification, the emulatof 
application sets the break inierrupt-enable function by using ihe SeQnUnfo routine. 
Now whenever the firmware receives a break characier. the Hmiware SCf: Intermpt 
handler records and cleais the interrupt, finally passing control lo the emulator's 
completion routine. This routine calls Gednrlnfo, and if the break bn is set, the 
completion routine knows that a break character has been rt^ceived 
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[Koie thai all interiupi sources (except receive and transmii) cause an intermpi on a 
■ Mjisition in a given signal. This means ihaE a user's interrupt handler will gel control 
[passed [o k on bcnh posscive and negalive transilJon5 in the signals of interest. For 

example, a break-chatacicr sequence causes two iniemjpts: one ai ihe beginning of 
1 the sequence and one at the end. 'Ilie user's tnlernjpL handler should take thi.s into 

accounL A rputijic can always determine ihe ciiment Mate oi the bits of interest by 

luiiig the GetPortStat routine. 

Tbe tniemjpt completion routine executes as part of the firmware inlermpt hancUsr 
I Hid muBl mn in ihal environmenl. [n addtUon. ihe following environment variabilis 
j aaist be preserved by your routine: 

t - SOD. e-0, m-1, x'l 

iJegtstefs Af X^ and Y nia;d not be preserved. 



BackgroLind printing 

Apple UGs aJlows you to print v/hiJe rurming an application program. Printing while 
jitDther program is ninning is called bacJE^rouuii prtiidng> Background printing is 
iMther eiample of output buffering, as described in (he s'secUon on buncring: In 
! Hckground printing, you send a block of characters over a serial channel on an 
iotcrrjpt basis. The major difference is that the firmware is handed a large numljer of 
diaracters to transmit all at once rather than getting them one at a trmc_ 

To print in the background, perform ihe following steps; 

1. Issje an Init call through the Pascal inierface. Thl.s ensures thai uhe firmware aJid 
hardware are active. The hardware chanc[erij;Lics (baud rate, dau format, and so 

on) will be as specil^ed in the Control Panel. 

2. Disable bu He ring using the HD serial command in case the Cnntrrtl Panel was sei tt3 
enable buffering, 

3. If you want to change the port characteristics, specify ihtm using either Ihe 

SetMindeBiis call or ihe Send command in the outpul flow. 

1 Sec the Duiput butter using SetOutBuITef. To use the default buffer, make a calJ to 
GetOutBufTer lo ascertain iis locaLion. 

!. Load the data into the buffer. 

i. Start the printing process with ScndQueue, pa.-»ing the length oF the buffer data and 
the address of the Recharge routine. 



Background printing 
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ISecharge routine 

Once you siart background prinUng with 2 ScndQueue caEI, the firmware sends ihe 
chaiacters periodically, in ihe background, until the buffer is exhsusLcd. When the last 
charaaer ia removed from Lhc buITcr, the firmware exeaites a JEL to lihe Recharge 
ronjiine, whose address was passed when ihe call 10 ihe SendQueue routine was made. 
ThL'i applicaijon-^upplisd routine reloads the buffer with the next set of data to be sent, 
a task [hat could involve some disk aciiviiy if the appticafion is performing background 
printing frcjrn ihe disk. Finally, the routine loads Lfw: number pf bytes in [he new block 
of data to be sent to the X and Y nsgLsiers (these wilH both be zero in case the 
background priming is complete) and cxecules an RTL, Requirements for the Recharge 
routine arc a* Toilows; 



On ftntrv 

System speed ■ fast 
DDR - $00 

Native mode (that is, m - 0, x « 0, e - 0) 



On exit 

System speed - fast 

DBR ^ SOO 

Native mode, &-bit m and x (e == 0) 

X register = data si2c Clow) 

Y regl^Leir = daLa size (high) 

Note that the Rcch.ai£c muiine 15 called at intennipt time. Therefore, you should 
regard ii as an interrupt handler, in the sense ihal anythtng it changes must be 
restored. Also note thai. internjpEs are disabled during the lime the Recharge routine is 
njnning. If too much time is Spent in this routine, performance degradation of 
intcrrupt-cri[ica] processes will occur An incernjpt-critical process is one such as 
App[e'i'alk that has stringem interrupt-responsc requirements, 

♦ Note: The firmware reserves the last byte in the data buffer for empty buffer 
detection. Make sure that the buJTefs size l*^ 1 byte larger than the amount of data 
you place in it. For example, if GetOulHuffer reveals an output bufTer of 2048 bytes, 
only data lengths iess than 2048 should b«? passed with the background- prinung call 
Or Recharge routine. 
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Extended interface 



Tlie Apple tIGS system has extended call features not preaenl in ihe SSC, These calls 
jic made Lhrough the extended interface and arc divided inlo three graups: hardware 
con^ol, mode conirol, and buffer-msfiagennenL features. A ii&[ of die extended 
inlerface calls follows ihis seaion, 

You can make a call ihrough ihe extended interface using [he following melhod; 

1. Determine the dispatch address by adding the value $CN0O to the value located at 
iC\l2. The byte at SCN12 is called the optional contrr)! rouUne ojfm of the Pascal 

1.1 prolcjcol. 

2. Perform an emulation-mode jSK (DBR " $003 to this dispatch address, with the 
address of the command lisl (CMDLIST) in the appropriate registers as follows: 

ffeglilflF B«glit*r vqIub 

A Address of CMDLIST Gow) 

X Address of CMDUST Cmcdium) 

Y Address of CMDLIS'I' Chigh) 

E^'ery command list stalls with a 1-byte parameter count Cnot a byte counO, a 
cotnmand code, and space for a result code. The pos-iible result codes returned are 
iisled in ihe section "Error Handling" earlier in this chapter. 

* .Vote; If you want to ensure that your applii^Lion will work with future systems, limit 
the use of hardware control calls, particularly ihe Gel SCC and Set SCC caJIs. If 
fijture systems use hardware othcf than the curtent serial chip (SCC 8530). your 
hardware control calk will mosi likely have to be cfianged, 

Ifl the extended serial interface descriptions that Follow, a Df^ is an asserabler 

directive that produces a single byte, 3 DW is an assembler directive that produces a 
'iEDjble byte CliS-biis: low byte, high byte), and a, DL 15 an assembler difecUve Ihat 

produces a doubSe word O^ bits, ihat is, i byles). 



Impartanf 

DlffSfSnf InslTuctfons require ^at □ difTerent nunnber of bytes be reserved fof the 
raturn parameters. Be sure that the CMDLIST buffer oreo to which you point Is 
large enough to hold all of the bylea of thte (efurn fMrometens (or ttxit command, 
'your buffer area b rxst large eniough, the system may foil, 
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IVIode control calls 



GetM9d@Bit» 

Relurni the airrcnt mode bi[ seuings. 



CM D LI ST 



DFB 
DFB 

DL 



S03 

soa 

SOO 
$00 



Parameter count 
.Command code 
Resuk code CouLpul) 
ModcBitlmage (oulpuO 



This call allows the applicaiion 10 deteirnine the status gF various firmware operaling 
modes. Four bytes OZ biis) of mode inforrrtaiiDn are returned To change any of ibese 
bits, use' ihis tall lo gel the current settings^ then alter the bits of interesl, and Lhen use 
[he SttModeBits call to make the actual modificaEion. (To avoid race conditions in 
Ihis process, be sure 10 disable iaterrupts during Uie reading, altering^ and wriiing of 
ihe bits.) The meaning of each bil is described beio'V. 



SetModoBiis 






Sets the mode bits. 






CMDLIST DFB 


$03 


uParameter count 


DFB 


JO] 


iCommand code 


DW 


$00 


;Rcsu[t code {output) 


DL 


ModeBitlmage 


iOnput) 



Use this caU to alter any of the mode biis whose function is described above. Fix^t resd 
in Oie bits using GeiModeBits. then alter ihe bits of interest, and then write the bits by 
using this call. CBe sure lo disable inierrupls, as discussed in the GclModeEit'S 
descnpiion.) The bits marked Preserve should not be changed; they are informational 
only. Altering these bits will confuse the firmwariL', 

ModeBitlmage is 4 bytes, where bit is the lent significant bit of the lowest addressed 
byte and bit 31 is the most significant bil of the highest addressed bytC. 



[31..Z4] 


CPreiveive) 


[231 


1 = Ignore commands in the output flow 


[22] 


1 ■ Framing error has occurred 


121] 


CP reserve) 


[20] 


1 - Parity error has occurred 


119.1^1 


(Preserve) 


[l~^.. lUI, 


^.t itscii* l:j 


[151 


(Preserve) 


[H] 


CPPEserve) 1 ■ I/O bufTcring enabled 


[33] 


1 ^ DCD handshaking enabled 


[IZ] 


(Preserve) 


llli 


1 = Generate Clt u end of tine 



11 

rs 
ts 

17 

if. 

[4 

[3 

(1 

[C 



6 
Q 

R 
C 



r 



G 

R 

C 
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110] 



171 
[61 
[51 
[4] 

131 
[2] 
[1] 



(Preserve) 1 ■ Input flow halEed 

CProscrve) I = Oucpui flaw baited 

(Preserve) 1 = Eackgroiind priniing in pfogress 

] = Echo input lo the video screen 

1 - Generale LF after CR 

1 = XON/XOFF handshaking enabled 

1 = AcccpE keyboard [npui 

- Delete LF after CR 

1 « DTR/DSR handshaking enabled 
CPrcscrve) 1 = awaiting XON character 

(Preserve) 1 = ODmmunicaiiorui mode, =■ printer mode 



Butfer-monagement calls 



GerinBuffer 

Returns the address and length of the input bulTer. 



CMDLIST 



DFB 
DFB 

DW 

DL 

DW 



510 

500 



Parameter count 

Command code 
Result code (output) 
Buffer address (outpuO 
Buffer Ienj5ih (ouipuO 



TTiis call and the one that follows (GetOutBufTer) are u£ed to determine the addre&ses 
and lengths of the currsrsi input and output buffers. If background prinUng is to be 
invoked and ihe application wants to use the de^ult buffer, its address can be lEtrieved 
by these calls. 



GetOutBuffef 

Returns the address and length of the output buffer. 



CMDLIST 


DFB 


504 




DFB 


Sii 




DW 


SOO 




DL 


soo 




DW 


SOO 



Parameter couni 
Command code 
Result code (output) 
Buffer address Couipui) 

Buffer length (output) 



Extended Jntertac© 



101 



SetTn Buffer 








Specifies the bulTer 


to contain Lhe Inpu: 


queue. 


CMDIIST Dh"B 


$04 


iParametcr count 


DFB 


SIZ 




Command code 


OW 


soo 




ResuU code (ouLput) 


DL 


BLffer address 




Cinput) 


0W 


BufTer Eeng[h 




Cinpul) 



ITiis wt] and lhe one following CSelOulBulTer) allow the appEication to change the 
location and lengih of the inpui or oulpui buffers, A queue buffer can cross bank 
bonjndsries buL must be fixed in memory while buffering is active. 



Seto lit Buffer 

Spedl'ies the buffer to contain the output queue. 



CM D LIST 


DFB 


^04 


Parameter couni 




DKB 


tl3 


Command code 




DW 


$00 


Result code Coutput) 




DL 


Buffet address 


(input? 




0W 


Buffer length 


Cinput) 



FlushlnQueue 

Discards ali characters in the input queue. 

CMDLIST DFB 
DFB 



£02 
$14 
$00 



.Parameter count 
Command code 
Result tode Cuulput) 



This call and the one following CMushOutQueue) aJlow the application to flush 
URWaRled Ma ffOHi the IfipUl md oULpUl queues. 



FlushOutQueue 

Discard^ all the characters in the oytput gyeye. 



CM D LIST 



DFB 

DFB 



$02 
$15 
$00 



Parameter count 
Command code 

Result code Coutput) 
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Betums information about ihe input queue. 
CMDLEST 



DFB 


$04 


DFB 


S\S 


DW 


$00 


DW 


$00 



DW 



$00 



ParametQf Count 

Command Code 

Resull Code (output) 

Number of characiCfS in receive queue 

(oulpuO 
;Time since last receive character queued 

(ouipuC 



ThL? call snd the onq foltcwing ^OuiQSlatus) call return inJormalion about the input 
and output queues. The InQSlatus call additionally returns the nurriber of hearibeac 
[ides (1 tick * 1/30 seconift between ihe lime the bsi charaaer was quisucd ajid the time 
of the call. Note that for this number to be valid, the application must have turned on 
ibe heartbeat system by making a tool call. 



OufQStofuS 

Heturns information about the output Cjueue. 



CMDLIST 


DFB 


$04 




DFB 


$37 




DW 


$00 




DW 


$00 



DW 



$00 



Parametcf count 
Command code 
Result code (oulpul) 
Number of characters until Lransmii 
queue overflow CoutpuO 
;Reserved (nuiput) 



SendQueue 






Launches back>?round printing. 




CMDLIST DFR 


504 


jParameter count 


DFli 


513 


^Command code 


DW 


$00 


jResulE code (output} 


DW 


Data length 




DL 


Recharge address 





TTiis call begins the background-printing procesis. The application must first set the 
Dutpui buffer address Cor use the default buffer) to load the data to be output into the 
buffer starting at. the buffer base address. The data then is placed into the buffer. Ttic 
rail Eo SendQuexie then must be made specifying the length of the data In the buffer 
and the 4-bytfi address of a subroutine (the Recharge rouUne), which will be called by 
the intermpt firmware when aJl characters have been sent. (See the section earlier in 
this chapter for further iJiformalion about Recharge.) 
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Hardwore controt calte 

Refer to rhe section "Compatibiliiy" ai Uie beginning of this chapter. 



GeiPoffStot 

Returns the port hardware status- 



CMDLIST 



DFB 
DFli 

DW 



S03 
S06 

$00 

soo 



jParameier count 

jCommand code 
jResuli code (output) 
■Port status info (output) 



[15. .81 




E7] 


Break/Abort 


16] 


Tx IJnderrun 


f5] 


DSR 


Ml 




13] 


ncD 


12] 


Tx Buff Empty 


[1] 




[0] 


Rx Char Avail 



lliis call is used to get the current status of the serial channel at the Iiaidw^c level. 
There are 16 bits of resulL The meaning of these bits is M follows; 

(Reserved) 

Set to 1 when a break sequence is deteded 

Set Lo I ^hen a iransmit undernun txicurs 

Stale of the input handshake line 

(Reserved) 

Stale of [he general-pnjrpose input line 

Set to 1 when ready to transmit nest character 

(Reserved) 

Set to 1 when a character is available to be read 



GelSCC 

Returns [he value of the specifred 5CC register. 

Parameter count 

Command code 

.Result ccxle (output) 

;SCC register number (InptiO 

iValue of sec register (ouipuO 

GeiSCC returns the value in a spedHed SCC register. The GeLSCC and SeiSCC calls 
allow direct access lo the serial hardware. (See the SCC S530 technical manual for a 
description of the registers in the serial controller chip,) iTie serial-port [jrmwaie 
does not need lo be iniUafced f^r these calls lo work; in fact, these calls should be used 
only if the application is handling ail serial tastes Itself and not usin^ the firmware at all. 



CMDLIST 


DFB 


$0^ 




DFB 


$08 




nw 


SOO 




DFB 


Register 




DFB 


$00 



Sc 

a 



Tt 

a 



th 

a 



CI 



n 

as 
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SefSCC 




Writes a value into the SCC, 


CNIDLIST DFB 


SO 4 


DFD 


.$09 


DW 


$00 


DFB 


Register 


DFB 


Value 



iPaiameter counl 
;Coriiinarid codL* 
;Resuk code (outpuQ 
■,SCC rcgiifler to write tinpul) 

-(ValuL- Lu viiritti lu Ri^gijler (Input) 
ifs call allows ihc willing of a register in the SCC 



[GelDTtt 

Ijiecunis Uie value of the output handshake line. 

ICMDUST DhB S03 iParameler count 

-Command tude 

;Re£ljlL CLXlf (uuLpul) 

;Sil 7 is the state of DTR (output) 

JLse ^is call to find out iht current setting of the output handshake line Tlit: state oF 
(iiis line is returned in the mosL ^ignifiiLani bit of the returned byie The Liie may be sei 
by the SetDTR call. 



DhB 


S03 


DFB 


SOA 


DW 


soo 


DW 


$00 



ISfrtDTR 
Sets the vilue of the output handshake line. 

iParamcrlcr Ltjunt 

-Cammand code 

iKe^ult tude (yutpul) 

.Bit 7 is the state of DTR (Input) 

Use this caJ to sel the current mode of Iht: tjutput handshake line_ 



CMDLIS'J" 


DFB 


S03 




DFB 


SOB 




DW 


SOO 




DW 


DTR state 



GeHntlnro 

Ketums the type of interrupt (for uge in the interrupt complctiun routine}. 



CMDLIST 


DFB 


503 




Parameter count 




DFB 


30C 




Command code 




DW 


$00 




Kesuk todc (cjuipui) 




DW 


500 




(output) 




DL 


CompieUon 


address 


Couiput) 



This call aUows the application to determine which type of interrupt caused ihe 
application's completion rouiinte to be called The meanmgs of the bits arc the same 
as for iScilnLlnfo. 
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Setlnflnfo 






Sets tip inTonnadonal intcrrupL handJingr 




CMDUST DFU 


S03 


Psfameter count 


DFB 


$0D 


Command cade 


DW 


SOO 


Result ccxie (output) 


DW 


IntCrrupl E^lLing 


(output) 


DL 


Completion address 


CinpuO 



This call allows \he application to specify ibe types of interrupts that wJI be passed to 
the application's intcrmpi routine. The firmware should be enabled and buffering 
Uimed on when this call is made, The types of intenupis and ihe bits used lo enable 
ihem are as shown in Table 5-7. 

llie extended serial-port commands are summarized in Figures 5-4 and 5-5. 

TabiB 5-7 

Interrupt setung enable bits 



[15. .8] 


(Reserved) 


17] 


Break/Abort 


161 


Tx Underrun. 


151 


CJ'S 


[41 





131 


DCD 


(2] 


Tx 


tl] 





[D] 


HX 



Sei these to zero 

Break sequence detect 

TranjsmJi undernin detect 

Transition on input handshake line 

(Reserved) 

Transition on general-purpose line 

Transmit register empty 

CHeservtd) 

Character available 
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j 

i 










i^^H 


G^nniuVet 


2 
2 


eatOutBuffert 


i 
1 
2 

3 


SetlnBLjffer 


Pofom&rer count ~ $04 


Paiameter count = SCW 


Parameter count = J04 


Command ccda = 510 


Command code = S 1 1 


Command code s s 1 2 


Result code 


l^esull code 


RcEu. ■ code 


Buffer bo5e addfess 


Buffer bose address 


Biiffef baae adclres$ 


Buffer length 


Buffer lengtti 


Buffer lenflth 


Return loccilion and length 
1 Cyl \h& racelvs queue buffer 




Return location and lengiti 
of the (fdnsmit queue buftef 




;iei >0'l:ij;;u.'i una lDn-g1l" 

or tihe receive queue buffer 


^^^1 SelOutButfar 


1 
1 

£ 
?. 

1 

2 
2 
2 


FluihlnQuA'Lie 


i 


FI'usriCutQuauH 


^^^H Parameter count ^ &04 


ParomeJef count » $02 


Pofamoter count = S03 


^H Command coda = S13 


Commond cocM ^^\a 


Command code * 5 ]6 


^H 


iJasuir codc- 


Result cocte 


^H ^uffef bass address 


Tnrow away qll chorocterj 
In the receive queua 




Throw dwov oil charoclers 
In tne Ironsmlt queua 


^^^_ BuTfBr length 




^^^B Sotlocarign anc3 igngth 
^^^B of tha Transmit qu9ij@ Cuffef 








^H Ir^QStatus 


CrutQSIatys 


2 
2 


S9r>dOu«U* 


^H Pardmorer count = SO^ 


Poromarer count = 304 


Paiamsfer count = StW 


^H Command code > S 16 


Command code ^ S 1 7 


Command codas' 5 18 


^H lj>&;ulT code 


rte^ult code 


(Result code 


^^HU Nurnbdr of characters 
^■^ in receive qusus 


rJumber of choracter spaces 
left in transmit queue 


DoTo lengtn 


^H Number of ticks imce 
^^1 id^i cf^aracf&i orrlved 


l^eserv^O 


Completion addresi 


^^B ?9turn recBive queue Inforrndtlor 
^^Lj Sumfnory o* e-xtended sertaii^ 


ortt 


eturn transmit oueue InformatioT 
3uff&r commands 


1 


Bftfltn bdclcQround output 
Extended Interface 1 


i^^^^m^^^^^^^^^^^^^^^^^i 


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^H 


^^^H 


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^H 


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^1 



GfltModeBtti 


_ 


Pafctmeter count = 


soa 


Comrncmd cods ■ 


soo 




Result cooij 




SiT S&Ttingi 



ffeJurrr nrmw/Q(e mode btts 



S»eModf»Blts 


Pafometer count » S03 


-> 


Command cpde - SOI 


[Result code 


Sit settings 


J 



I (ifttfortstat 

^^TBramitgir count ^ 



■ter count ^ S03 



Com rr.ortd cogia s SC6 
i?esi^ code- 



Port hardware stotus 



1 



Set firmware mode bits 



Return the port srolus. 



GfttSCC 



PorametG! count a StW 



k Command code = SOe 



R^ult eoalG 



sec registar nunnDer 



ReQisfer value reaa 



SetSCC 



Pa'ameiar count ^ S04 



Command code = SD* 

.^ — ■-—*•■■ — 



Result code 



sec teglsfar nufno^r 



GetDTR 



■^osult code 



OTR sfate fbit 71 



Porametgr count ^ Sffij J i 
Command code = SOA M l 

2 



QsBistei valuB to write 



1 Return siate of output handshoks 



Return on sec fi53C register voluo Wrrte an SCC S53G r^gl^e, ™iue [ "mdcar^, mpgr parameter" "| 



SbIDTP 


Porametef counT « S03 


1 Commano code - SQE 


iasuir code 


^*^^°ii^a»h ■ 



Set sTaTe ot output hondsJio-te 



GeHnllnlo 



Parameref counr - $U3 



Commond code = SOC 



.^esull code 



BIT setting 



Completion 'OJtIne address 




RsrurninTqrmotlonal interrupt by^e £9tintoJfT;otnOnal interrupt par-amete-'s 



Summary of extended seridl-poit mode and hordware control commands 
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This chapter describes ibe Apple HGS Disk IT support. Several different vypes of disk 
drives can ha attached Ui xhe Appl(j [IGS, .some of which contain buDll-m intelligence. 
This chapter describes the meihoda by which the Disk IE product can be cormecied to 
the Apple IIGS. 'Hue Apple lldS disk-support sysiem, with its buiU-in Integrated Wo?, 
Machine (iWM) chip, acccummodates Disk II CDuciDisk and IJniTMsk) 5,25-inch drives^ 
3.5-inch drives with buik-tn intelligence (UniDisk 3.5), and Apple 3-5 drives. 

The r*'M divides the Appte IIGS disk pom Ccan the back of the computer) into I/O ports 
5 and 6. The ports are equivaEeni lo inlernaS veraans of device drtvefs installed in 
expansion slots 5 and 6, respective ty. Tlie Control Panel setting for sIot 5 or 6 
dei£;.rmint:.s whelher the I/O port or a, card physically present in thai slot is active. 

Port 6 provides the standard Disk 11 support. Disk 11 boot routines arc built into ROM 
Disk II routines in DOS, ProDOS, and Pascal operate the same as they do in Apple H 
computers prior In ihe Appfe [IGS. Direct access lo DLsk II devices (reading and 
writing tracks and sectors, seeking to specified tracks, and so onD is provided by 
whichever operaiing system you booL Sepa^te firmware support is provided only for 
booting from Disk 11 devices. 

Port S is called SmartPon. It consists of an expanded version of the SmartPort 
Grmiware used in the 32K Apple It liOM SmartPort is capable of supporting a 
combination of cfiaiacter and bkick devices up IQ a total of 127 devices. It conirols the 
UniDisk 5.5 and Apple 5-5 drives as well ai5 the ROM disk and tlie RAM disk. The 
SmariPart firmware is discussed in detail in Chapter 7, "SmartPort Firmware " 

You can attach up to two Disk 11 drives, two Apple 3-5 drives, and two or more 
UniDisk 3.5 drives to the Apple IlGS disk pnrt, depending on IWM output 
speciiications. A maximum of six devices can be connected at any one lime. The disks 
musl be attached in the order shown in Pigurt: 6-1 (Apple 3.5 drives Hrst, followed by 
UniDisk 3.5 drives, followed by Disk II drives}. 




Appia3,5 
drive 



Apple 3,5 
dnve 



UnlDlsk 3.5 



I/O pari 5 



Disk 

{UniDlsif 5.25 and 
DuoDisk dflves) 

I/O port 6 



Figure 6-1 

Order of disk drives on Apple ires disk poriB 
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interface lOLitJnes for ports 5 and 6 access ihe TWM using slot 6 soft switches, 'fhe 
Fiimware arbitrates between slot use of the same soft switches. If a peripheral card is 
plugged into &(ot 6, Ihe Firmware in port 5 can stiJl access ihe disks cnnneaed to port 6 
by lemporaiily diiabling the; extemai peripheral card, performing disk access, and 

liien reenabling the externa] peripheral card. 

Tlie port 6 disk interface firmware resides in ihe SC6O0 address space. It supports up io 
two drives, addressed a.s though they are conr^ectcd lo slot 6, as physical drives 1 and 
Z. Both drives use singte-sided, 143K-capacity, 35-track, l6-sectQr rormaL Table 6-1 
summarizes the Disk II I/O port characlerJstlcs, 

Tabi* 6-1 

D^ El \/0 port characteristics 



Drive number 

Commands 

Initial characteristics 

Hardware location 

Monitor firmware routines 
I/O nfm9/are enLry points 

Use of screen holes 



Pon 6, drive 1 
Port 6, drive 2 

rH#5 or PRf6 from BASIC or Call ^151 (to gel 
\Q Monitor from BASIC) and S Control-P 

All resets with valid reset vector, except Conlrcil- Resets 
pass control (^ slot 6 drive 1 if this drive is set (through 
Control Panel) as boot device or if scan is selected and 
nes boot volume is found in higher-priority slot 

internal, SC;OE0-$C0EF, reserved for Disk II and 
SmartPort use 

None 

SC600 (port S boot address) 

SC65E (read first track, first sector and l^egin execution 

of code found there) 

Port 6 main- and auxiliary-memory screen holes 
reserved 
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startup 

The Apple IIGS can be sianed by using either a cold sian or a warm siart. A cold siart 
dears the machine's memory and tries to load an operating syslcm from disk. A warm 
Stan stops the program currencly running and leaves the machine in AppSesofi BASIC 
with memory and pragram^ intact 

A cold start can be initiated by any of the foUowing; 

a turning the machine on 

n presLSing d-Control -Reset 

n issuing a reboot command from the Monitor, from BASIC, or From a program 

u pressing Gonirol-Reset: if a valid reset vector does not exisi 

IF you have set the sianup device Cfrom the Control PaneD lo slot 6 or if you have 
selected scan and no booi volume is found in a hiaher-priorily slot, ihe cold-start 
routine first sets ^ number of soft ST/itches (see Appendix E, "Soft Switches") and ih^^n 
passes conLrol lo ihe program entry point at SC600. This code irurns on the Disk ]l 
unit 1 device moior and then recalibrattis the head to track and reads sector from 
that track. The sector contents are loaded into memory starting at address S0800; then 
program control passes to $0801. The program loaded depends on the operating 
System Or appllcslion program on the disk. 

To reitan the system from BASIC, issue a PB*6 command; from the Monitor 
command mode, issue 6 Conlfol-Pt and from a machinc-l^ngu^ge program, use JMP 

mm-. 

A wann sian tegin? when you press Control -Reset if a valid reset vector exiivLs 
Normally, a warm start leaves you in 13ASIC with memory unchanged- If a program has 
changed the reset: vecior, the system will not perform a warm staji. Usually, a program 
either performs a cold start or beeps and docA nothing, leaving you in Lhe currently 

executing program. 
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The SmaitPort nrmware is associated with I/O port 5 (internal slot 5). U consists of 
assembly-language routiiiies that, support a scries of black or character devices 
connected to ihe Apple IIGS exttmal disk port. The SmartPori (Irmware converts calls 
to an apprcpriaie fonnai for transmittal over the disk pen lo control intelligent 
devices, thai U„ devices that can interprei command streams, such ss ihe UniDisk 3-5 
diive, 'I"he SmarlPort also provides an interface to several unintelligent devices, that 
is, devices thai require specific hard^^.'are control and employ no built-sn intelligence, 
through the use of device-specific drivers that are accessed through the SmartPort 
extended interface calls. Uninlelligent devices supported on the Apple IIG5 dirDugh 
the SmarlPort include the Apple 35 drive, RAM diski and ROM disk. 

To use the SmartPort inLerface, a program is$ues calls similar to ProDOS 8 machine- 
knguage inierface calls. Each call consists of a JSR to die SmartPort entry point, 
followed by a SmartPort command byte, followed by a pointer to a table containing 
the paiameters ncce^^sary for the call. The calls lo SmartPort take twcj possible forms. 
The standard version of a call allows your program to move data lo and from bank JOO 
of the memory. You use the extended version of the ca!l tci move data to and from 
olher banks of memory. 



Locating SmartPort 

You can determine wheiher the SmartPort interface is installed in a system by 
examining the PfoDOS block-device signature bytes shown here 

SCnOl - i20 / 

SCn03 " JOG / 

SC11O5 - $03 / 

You must also verify the existence of the SmartPort signature bytci 

iCn07 - $00 

In the preceding addresses, n is the sEot number for which the signature bytes are being 
examined. AJ peripheral cards or ports with dicsc signaiu re-byte values support both 
ProDOS blocfc-devlce calls and SmartPort calls. You can examine the SmartPort ID 
type byte to obtain more information aboul any special support that may be buiti into 
Ihe SmartPort driver, The SmartPort ID type byie located at 5CnFB has been encoded 
to indicate the types of devices that can be supported by the SmartPort driver. This 
byte pertains to the interface only. For example, the Apple riGS SmgciPort inierface in 
internal slot 5 m^y support a RAM disk, but it is not a RAM card, so bit is cleared 
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H Figure 7-1 iJIustrates the contents of this ID type byte. Note ^ai a driver that supports 
H soeriided SmartPorl calls must also support standard SmartPort calls. Bit 1, SCSI, 
^1 indicates support for ibe Small Compiler SysEem InlcrJace (SCSI). 

RAM card 

SCSI 

l^esefved 

Extanded 



SmartPort ID type 



3CnF& 



Flguf*7-1 

SmartPort ID type byte 



Locating the dispatch address 

Out* yiju Ua-uc JdieujJBicU itiai :i SiisaiifufL iuLtiirate exists In a aim or pfon^ you need 
to determine ttie enLiy point, qr aispatcH &^dre^, tor ihe SmartPort, This address is 
<lttemiiined by the value Found at SCnJT, where n Is the slot number By adding ihe 
jvalue ai $CnFF lo the address $CnOO, you can calcuJaie the standard FroDQS block- 
[cfevice driver entry point. More informaLion aboui ihis entry poinl is available in the 
\ProDOS Technical Reference. The SmartPon entry point is located 3 bytes after die 
[ProE>OS entry poin\. 'fherefore, the SmartPort entry point is SCnOO plus 3 plus the 
Value found at SCnFT. 

[For example, if the signature bytes for tiie SmarLPon imerface are In slot 5 and 5C5FF 
Kxitains a hexadecimal value of SOA. the ProDOS entry point is SC50A, and the 

[SmartPort entry point is SC50A plus 3, or SC50D. 



Locain^ the dispatch od'dr&ss 
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SmajtParL calls includt: several parameters. Not all pammeEers appear in every 
SmartPort call 'ITie parSumeter types ihal may be required when making a SmartPort 
call are as follows; 



Command name 
Command number 



Parameter list pointer 
Parameter count 

Unit number 

Buffer address 

Block number 

Byte count 
Addiess pointer 



Name used to identify the SmartPort catl 

Byte value that you position contiguous in memory with the 
JSR 10 ilie SmanPori enuy point; hexadecimal number ihai 
specifies the type of SmartPort: caEl Cbit 6 is cleared to for 
standard calls and set to 1 for extended calls3 

Pointer that you position contiguous in memory with the 
command number that points [o the parameter lE^l 

The flcsl item in the parameler list; hexadecimal byle value 
that speafies the number of pararneiers iii the parameter 
Use 

Hexadecimal byte value that specifies the unit number of 
the device to or from which the SmartPoit call is to direct 

I/O 

Pointer 10 memory thai will be used in the I/O transaction 
Cfor standard SmartPort calls, this is a word-wide pointer 
feferendng memory in bank zero; for extended calls, the 
pointer is a iongword referencing memory in any banlO 

Number spedf/ing the block address used in an I/O 
transaction widi a block device (for standard SmartPort 
callSj this parameter is 24 bits wide:, for extended calls, this 
parameter L<< 52 biis wsde) 

Specifies the number of bytes [o be transferred berween 
memory and die device (this parameter is l6 bits wide) 

Specifies an address within the device 
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SmartPort assignment of unft numbers 

"Oie unit number L-v included in eveiy parameter Use. 'fhe unii number specifies which 
device connecied to the slot 5 hardware responds to ihe ctimmands you issue. Calls 
that allow you to reference the SmartPort iL-itlf u5e a unit number of ^em. Only Siatus, 
Init, ind Control calls may be made to unit acro. The Apple IICS assigns unit numbers 
to devices in ascendi^sg order staning with unit number $01. Devices are assigned unit 
numbers stirting wilh the RAM disk, ROM disk, and Apple 3,5 drive, and finally 
prnceeding to intelligent devices such as the UniDisk 3.5. 



AllocaHon of device unit numbers 

The Apple riGS implementation of the SmartPort interacts wilh ihe Control Panel 
Seleclicn of boot devices. For any given port, a boot can occur only frnm the fitst 
dtvioi loBically connected to thai port. Booting rrom Disk II devices is handled by the 
ilot 6 firmware. Sm.artPoft support is provided lo allow booiina from any of three 
lypes of devices; 

n RAM disk 

□ ROM disk 

1 D Diisk drive CApple 3-5 drive or UniDisk 3,53 

Depending on the devices that are connected to the slot 5 hardware, the selected boot 
device may not be the firsi logical device in the chain. To boot from the selected 
device, using the Conuol Panel setting, the SmartPort firmware logically moves the 
selected device to the first unit in the device chain_ All devices that were previously 
ahead of the selected boon device must then be moved logically so thai they are now 
[ocated behind ihe selected boot device, 

Ihe initialization call handle5 assignments of unit numbers in a t«vo-siage process. In 

ihe ^rstsUge. uriit numbers arc assigned as described above, in the section 
'SmartPort Assignment of Unit Numbers." In the second stage, Ihe units are 
remappGd so that the selected boot device is always the first logicaJ device in the 
chain. If Scan is selected as the boot option in the Control Panel, die SmartPort places 
the first physical disk drive as the first logicaJ device in the device chain. 

Device remapping is necessary for certain device configurations under ProIX>S. 
: Current Implementations of ProDOS (both ProDOS 8 and ProDOS 16) support only 
I two devices per port or sbt. If more than two devices are connected lo ihe device 

'^ain, devices beyond the second cannot be accessed ProDOS 8 and ProDOS 16 gee 
iround this restriction by logically mapping devices beyond the second device *0 that 
ibey appear to be connected lo slot 2, Using this method, ProDOS S and ProDOS l6 

can support up ip four devices on tfie chain. 

* At)i£ Future versions of ProDOS 16 will support more than two devices per port or 
slot so that no remapping of units to slot 2 will be necessary. 

SmortPort assignment of unit numbers 
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Figures 7-2 through 7-6 show device rcmappEng derived from ihe selecied boot device 
versus the device conJigu ration. Only a few of the possible remapping variaiions are 

shown. 
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Issuing a call to SmartPort 

SmartHort calls Tail inio two caicgoi]!:*: atindard calls and extended calls. Standard 
SinartPort calls are designed for inierFadng Apple II peripheral. Extended SmartPoft 
calls are designed For peripheral devices that can take advantage oFthe 65Sl6 
processor's aibilicy if* transfer data between any memory bank and the peripherji] 
device and may require larger block addressing ihan is possible with liig .sLandard 
SmartPort calls, 

For standard SmartPort calls, ihe poinier following die SmartPort command byte Is a 
word-wide pointer Lo a parameter list in bank zero. For extended SmanPort calls, the 
pointer is a longword pointer to a parameler list in any memory bank. 

Tliere are several consiriint^ on the use of the SmartPort: 

n 'I'he slack use is 30-35 bytes. Progrsms should allow 35 bytes of stack space for each 
call, 

□ 'I'he SmanPort cannoi generally be used to put anything into absolute zero page 
locations. Absolute zero page is defined as the direct page when ihe dired register us 
set lo 50000. 

□ The SmartPort can be called only from Apple 11 emulation mode. This means that 
the emulation flag in the S5C816 processor status byte must be set lo 1 , and the 
direci-page regisler and daia bank icgisttrr mu^i boih be set 10 '^ma. Native-mode 
programs wishing to call the SmartPori must switch to emulation mode prior 10 
making a SmanPod cal!, SuCh program.'; may cau.se Ct>rri:ption of the contents of 
the stack pointer. Refer lo Chapler 2, "Notes for Programmers," for more 

informatipn about s^wilching processor mndes- 

This is an example of a standard SmartPort call: 

;Call SmartPort coiriindnd dispatcher 

;Tms specifies the commar.d type 

iWord pointer co tlie parsnie-cer last ir bank SQQ 

jcarry Is sec o?i as\ error 



SP CALL JSS 


DISPATCH 


DFB 


CMDHDM 


DM 


CW&LIST 


BCS 


ERROR 


This is an example of a 


extended Sn 


3P EXt CALL JSR 


DISPATCH 


DFB 


CMtJWUM + $4 


QW 


CMDLIST 


DW 


" CWDLIST 


BCS 


ERROR 



;Call SmartPort command dispatcher 
;This specifies the flutonded command typa 
; Low-word point&t to the pAtimetsr list 
.■High— Word pointer tD the parameter list 
;i^flrrv is set nn an Error 

On eempledon af % eaJI, eKGCLiiiofl fetums to the in^S addfe£§ plus 3 fof i standard all 

and to the KTS address plus 5 for an extended call CUie BCS staiemem in the 
examples). If the call was .5ucces5fiil, the C flag in cleared and tlic A rcgii;tcr I3 set to 0-, if 
il was unsuccessful, die C Hag is set and the A register contains the error code. If data is 
transferred from ihe ttevice to the CPU, the X register coniains the low byte count and 
the Y register contains the high byte count. 
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The complete itigisier .itaihjs upnn crvmpleiion is summarized in Table 7-1. 
Replsfef status on return froro SmortPort 



65iM ;tc3tiJ5 b/^o 



N V I » D 



Z C Ace X r PC 



SP 



Successful XXIXOUXOO nn JSR^-3 U 

standard call 

Stcwssfjl XXIXQIJXOQ nn JSR+5 U 

extended call 

UnsLiCcessful XXI X Q U X 1 Error X X JSR-H3 U 

SEadtlard call 

Urtsjccessful X X 1 X U X 1 Error X X JSR+5 U 
extended call 

' jVoiTp. X ■ Trndcfined, V - uncl^ngGd, n - undefined for iran^fef^ to ihe device of r^umber 
of bytea Lransferred v+ien Lhe iranifer was fiom ihe device to the heist. 



Generic SmartPort calls 

Generic SmanPan csils are explained in detail in the following sections. 



I 



Status 

The Statji call returns staius informaiion aboui a particukr djevice or about the 
SmariHoit itself Only Siatus calls that return general informaiipn are listed here. 
l>evicc-specifit Siaiuis: calls can also be implemented by a. device for diagnostic or 
cH-her information. Dcvicc-spcdfic calh must be implemented with a staius code of 
SOil cir greater On return from a Status C2ll, the X and Y regisign; cyntaln a couni of 
tiifi number of bytes uansferred to the host. X contains lhe low byte of ihc count, and 
Y contains Lhe high byte of the count 



Slandard call 

GMDNUM SOfl 

CMDLIST ParaiTicter count 

Unit number 

Slams list pointer Oow bytel 

ISiAtu.s lisf poimer (high byie) 

Status code 



Extended call 

Parameter count 

Unii number 

Status ILst pointer Oaw byte, low word) 

Status list pointer Chigh byte, low word) 

Status list pointer Gow byte, high word^ 

Status list pointer Oiigh byte, high word) 

Status code 

Generic SmartPort calls 
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Required paramefers 

Pariutietei' count Byte value = $05 

Unit numbGi' 1-byie value In the range $00, $01 lo S7E 

Each device has a unique iiiiTT±icr assigned lo it at tnitializaiiDfi lime. The numbers are 
assigned according to the device's position in the chain. A Stains ca6l with a unit 
number of $00 specifies a call for iJie overall SmanPon scaius. 



Standard caW 



ExtBndAd calf 



Status list pointer Word pointer (bank SOO) Longword pointer 

This Is 3 pointer to the buffer la which the staiua Est i£ to be returned. For standard 
calls, thii is a word-wide pointer defaulting lo bank SOO, For exlended calls^ this is a 
iongword pointer. .Note thai the length of ihe buffer varies, depending on the suius 
request being made. 



Status code 



1-byte value in the range 500 to SfF 



This is the number of the sianjs request being made. All devices respond to the 
Following requesL'^: 



StatLTJ 
code 

$01 
$02 
SOS 



StaKii r*turn«4l 

Return device status 

Ketjm device control block 

Return newJine status (character devices only) 

Return device informaiion block CDIB) 



AJthojgh devices must respond lo the preceding status requests, a device may noi be 
able to support the request. In ihis case, the device returns an invalid status code error 
CS2IX 

3lalcod» = $00: The device status consists of 4 byics. The first is the general status 
byte: 

ait FunctJoh 

7 1 = Block device; ■ Character device 

6 1 = Write allowed 

5 1 = Read allowed 

4 1 = Device online or disk in drive 

3 1 = Formal allowed 

2 1 = Media write protecled (block devices only) 

1 1 " Device currently interrupting (supported by Apple He only) 

1 = Device currently open (character devices only) 
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If the d^vict 15 a block device, the next field indicates the number of blocks in the 
device. This is a 3-t)ytc field for standard calls or a ^-b^te field For exiended calls. The 
leMi significani byte is first, If ihe devicE is a cha/aaef device, th^c bytes arc sat to 
aero. 

Shatcode - $01: The device control block (PCB") [s device cEependent. The DCB is 
typically used to coniTol various operating charact'tristics of a device. The DCB h set 
wiih ihe corresponding Control call. I'he first byte is the numter [jf byies in tlie 
coitu-ol blcfck. A v'alue of .^00 returned in this byte indicates a DCB length of 256, and a 
value of SOI indicates a DCD Icngdi of 1 byxc. The length of ^e r>CB is always in the 
range nf 1 [o 256 byies, excluding the count b/ie. 

Stafcode - JD2: No character devices are currently implemented far use on the 
SmartPort, so the newllne .status is presenily undefined. 

Sfatcode = $03; This call r^iums Ihe device informalJon block (DiB}. It conlains 
Lnfnrmalion identifying the device and its lype and various other aiuibutes, The 
returned status list ha^ the fallowing form; 



STATUST Slandard call 



Device status byte 
Block size (low byle) 
Block size Cniid byte) 
Block size (high byte) 
ID string IcrigLh 
[D string Cl^ byies) 
Device type byte 
Device subtype byte 
Version word 



Ext«nd«d CQH 

Device status byle 

Block size Oow byte, low word> 

Block size Qiigh byte, low word) 

Block size (low bylC, high word) 

Block size C high byte^ high word) 

ID siring length 

ID KLring (l6 bytes) 

Device tyiK byte 

Device subtype byte 

Version word 



The device status is a 1-byie Reld ihal is the same as the general status byte relumed in 
the device Status call Cstatcode - $0Q). The block sijs field is the same as the block siie 
field relumed in ihe device Status call. The ID string consists of ]-byte prefix 
indicating the number of ASCII characters in the ID string. ThLs is followed by a 
16-byte Held containing an ASCII string identifying the device, The most significant bit 
of each ASCII character is set to zero. 

If the ASCn string coa'^isls oF fewer than l6 i!haracTer,'>, ASCII spaces are used to fill the 
unused portion of the string buffer. The device t>'pe and device subtype fields are 
1-byte fieldi;. SeveraE bits encoded within the DIB subtype byle are defined to indicate 
whether a device supports the extended SmiartPort interface, disk-.s-wiiched errors, or 
femovabie media. 



Generic Sn^artPort calls 
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A breakdown of the DIB subtype byte is shown in Figure 7-7. 
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Flgur« 7-7 

SmartPort device subtype byte 

Applications requinng specific knowledge about a device should execute a DID status 
and examine the type byte. The subtype byte is used lo obtain information about 
special feature, a device may support. Several device types ind subtypes sre assigned 
to existing SmartPort devices, These types and subtypes are as follows: 

Typo Subtype □ avlea 

iOO SQO Appte II memory ei^pansion card 

500 SCO Apple nCS Memory Expansion Card configured as a RAM disk 

501 5Q0 UniDisk 3.5 

SOI SCO Apple 3-5 drive 

$03 SEtJ Apple II SCSI with nonremovable media 

Undefined SmartPort devices may implement the following types and subtypes: 

Typa Sublypa Dovic* 

Hard disk 

Removable hard disk 

Removable hard disk supporting disk-switched errors 
Hard disk supporting exJended calls 
Removable hard disk supporting eKiended calls and disk- 
switched errors 

Hard disk supporting extended calls 
SCSI with removable media 

The fij-mwaie version field is a 2-byte field consisting of a number indicating the 
firmware version. 



Th 

CO 

PC 

sc 
%i 



$oz 


^20 


502 


SOO 


502 


340 


S02 


SAO 


SQ2 


SCO 


502 


SAO 


503 


SCO 
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iTtPort driver status 

iStatus call wjih 3 unii nutriber of SOO and a sLatus code nf .$00 is a request in return the 
itus of [li« SmanPon driver, This Tjnciion rerurns ihc number of devices as well as 
1 cjirem inlernjp; stams. The format of tlic sutus list reiurncd is as follows^ 

ITUST ByK Number of devices 

Byte 1 Reserved 

Byte 2 Reserved 

Byte 3 Reserved 

Byte <I Ueservtd 

Byte 5 Reserved 

Byte 6 Reserved 

Byte 7 Reserved 

number of devices field is a l-bytc fidd indicating the lotal number of devices 
lected to the s3ol or port. This number will always be in Lhc range lo 127. 

P<QS&lble errors 
[llie Following error return values are passible. 

BLSERR CDimmunicaiiortS error 

'J2] BADCTL Invalid status code 

i30-S5F i50-57F Device specific error 



GBnerIc SmoftPort calls 
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ReadBlock 

This call reads one 332-byte block from ihe btodt device specifted by the uni: number 
passed in the parameter lisL The block is read into memory starling al Ihc address 
specified b^ the daia buffer pointer passed in the parameter list 



CMDNUM 
CMDLIST 



Standsfd pall 

$01 

Parameter count 

Unii n[]mber 

Data buiTcr pointer (low byte) 

Dau buffer poinier Chigh byte) 

Block number Qow byte) 

Block number Cmiddlc byEe^ 

Block number (high byte) 



Extendad caH 

Parameter count 

Unit number 

Data bufler pointer Clow byie, low word} 
Data buffer pointer Cilgh byte^ low word) 
Data bufTer pointer Gow byte, high word) 
Data buffer pointer (high byte, high word) 
Block number Qow byte, low word) 
Block number Onigh byte, low word) 
Block number Gow byte, high word) 
Block number (high byte, high word) 



Required parciin^ters 

Parameter count Byte value = %Q^ 

Unit number 1-byte ^lue m the range $01 to iVE 

Slanriofd ca8 iitflndJd cai\ 

Data bufler poJnter Word pointer (bank S00> Longword pointer 

'fhe data buffer pointer points to a buffer into which the dau is to be lead. For 
standard calls, this is a word pointer into bank SOO. For extended calL?, the pointer is a 
longword specifying a buffer in any memory bank. The buffer musL be 512 bytes lon^. 

Standard ct^y £xt9rid»d call 

Block number 3-byte number 4-hyte number 

The block number is the logical address of a block of data to be read. There is no 
general connection between block numbers and the layout of tracks and sectors on the 
disk. Translation from logical lo physical blocks is performed b>- the device. 

Possible errors 

The following error letum values an? possible. 

306 BTJSERK Communications error 

i27 lOEEROR I/O error 

528 NODRIVE No device connected 

J2D BADBLOCK Invalid block number 

i2F OFFLtNI: Device ofTline or no disk in drive 



w 

Tt 
nu 
ad 






U 



D 
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WiiteBFock 

TIk Write calJ wriEes one 512-bytfi block to the block device specified by the uriii 
number pissed in the parameter lisl. The block h wcitlen from memory starting at the 
iddress specified by ihe d^u buffer pointer parsed in the parameter lisL 





Stantfard cal 


Extendad caE| 


CMDNUM 


$02 


542 


CMDLIST 


Parameter count 


Parameter count 


i 


Unit number 


Unit number 




Data bijfTcf poinler Clow byte} 


Data bjffef pointer Oow b'^le, iow word) 



Data bulTer pointer Chigh byte) Daia buffer poimcr Chigb byte, low word) 



Block number (low byte) 

Block number Cfniddle byte) 
Block number (high byte) 



Data buffer pointer Clow byte, high word) 
Data buffer pointer Chigh byte^ high word) 
Block number Oow byte, low word) 
Block number (high byte, low worcO 
Block number Qow byie, high worcO 
Block number Chigh byte^ high word} 



Required parameters 

Parameter count Byte value = $03 

Unit number l-byte value in the range $0i to S7E 

standard call Exts'ndvdi can 

Data buffer pointer Word pointer Gjacik JOO) Longword pointer 

The data buffer pointer points to a buffer that the data is to be written from, For 
standard calls, this is a word pcjinter inio bank 500. For extended calls, ihe pointer is a 
longword specifying a bufter in any memory bank. The buffer must be 512 bytes long. 



Block number 



Slandard coll 

3-bytiE number 



Exiended ca3l 
'I'byte numbcj- 



The block number is the logical address of a block of data to be written. There is no 
generj] connecu'on between block numtier^ and the layout of tracks and seciors on ihe 
disk. The translation from logical to physical block is performed by Ihe device. 



Possible errors 




The following error return values are possible. 


S06 BUSERR 


Communications error 


S27 lOERROM 


I/O error 


S28 NODRtVE 


No device connected 


S2B >JOWRITE 


Disk write protected 


32D BADBI.OCK 


Invalid block number 


32F OFFUME 


Device off line or no disk in drive 



Seneric SmcirtPort colts 
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Format 

The Format call formaxs a block device. Note th^t the formatting performed by this 
cfilJ is noE linked to any opeiaiing system, li simply pitspares all blocks on the medium 
for readfng and writing. Operating-systemspedfic catalog information, such as b£c 
maps and catalogs, are not prepared by this cat]. 



CMDNUM 
CM DUST 



Standard call 

Parameter count 
Unit number 



Extvndsd cal 

Parameter cmint 
Unit numbRf 



Format call implemerttotion 

Some block devices may require device-specinc inforniaiion at format time This 
device^specific informaUon may include a spare list of bad blocks lo be written 
following physicai formaiiing of the media, in this case^ it may not be desirable to 
implement the Formal call so dial a physical format is actually performed because a 
spare lisL of bad blocks may not be avaiiabJc frum the vendor or because of Lhe time 
involved in executing a bad-blnck scan 1: may be more desirable (0 implement 
device-spcdfic Control calts to lay down the physical tracks and iniiializc the Sparc 
lists. 1/ this laner procedure is followed, the Format call need only return to the 
application with the accumulator .sei in $00 and the cany Rag cleared. This procedure 
should be used only when it is not desirable for the application to physically format 
the media. 



Required pyrometers 

FArameeer count Uyie value = $01 

Unit number Byte value in the range $01 lo $7E 



Possible errors 

The following error return values are possible, 



S06 
$27 
$2S 
S2B 
J(2F 



BUSERR Communjcations error 

lOERROR I/O error 

NOniRlVE No device connected 

NOWRITE Disk write protected 

OFFLr>fE Device offline or no disk in drive 
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Control 



The Comro! call sends control inforftatioti to the device. The infomiaLion may be 

eithcf general or device specifie 



Standard call 



Extendsd car 



CMDNUM $04 

CMDLIST Parameter count 

_ Uilic number 

Control li3t pointer (low byte) 



$44 

Parameter couni 

Unit number 

Conirol list pointer Gow hyie, low word) 
Conirol list pointer Qu'gh byte) Control list pninier (high byte, low word) 
Control code Control list poinier Qow byte, tiig,ti word) 

Control list pointer Chigh byte, high word) 

Control cadi^ 



R«^uir3d pOTometers 



I^ramecer count 
UdJt number 



Byte value - S03 

Uytc value in the range $00 to ^TE 
SFandard call Extondnd cpll 



CiHitrol list pointer Word pointer (bank SOO) Longword pointer 

The control list is a pointer to the user's buffer from which ihe control information is 
t&be read, for the standard Control call, [he pointer is a word value into bank SOO'. 
For the extended Control call, the poinier is a longword value that may refertncG any 
memoTy bank. Tlie (ii?t two b^les of the control list specify the lengifi of the control 
list, with Lhc low byte Hrst. A control list Ls mandatary, even if the call being issued 
does not pass iruformation in the list. In [his latter case, length of zero is iL-ied for [he 
first two bytes. 



Control code 



Byte value 

Byte value in the range $00 to $FF 



The control cpde is the number of the cofLiroi request being made. This number and 

Ihe function indicated are device specific, except that all devices musi resert'e the 
following codes For specific functions:: 

^od4 Control function 

300 Rese[s the device 

$01 Sets device control block 

402 Sets ncwline status (character devices only) 

$03 Services device interrupt 

Code = SOO: This call performs a soft reset of the device. It generally returns 
housekeeping values lo some leset value. 
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Cods = 501: This Control call sets ihe device control block. Devices generally use the 

bytejj in this block to control glciial aspects of Lhe (device's operatimg environment 
Because the tength is device dependent, the recDmmended way to se[ the DCB is to 
read in the DCD (with ihe Statu.s call), alter the bits of interest, and then write the same 
string with this call. The first byte is Lhe length of the OCB, excluding ihe byte itself. A 
vslue of SOD in the length byte corresponds to a DCB si-ia of 256 bytes, and a count 
value of SOI corresponds Lo a DCB size of 1 byte, A count value of $F¥ coiresponds to 
a DCB si2e of 255 bytes. 

Possible errors 

The following error return values are possible. 



S06 

S21 

ill 

530-5iF 



BUSERR 

BADCTL 

BADCTLPARM 

UNDEFINED 



Communications error 
Invalid control code 

Invalid parameter list 

Devicc-ipedfic error 



tnit 

The Init call provides the applicatign with a way of resetting the SmartPort 
Standard call ExUndsd coll 

CjMDNUM J05 J45 

C.MDI.IST Parameter count Parameter count 

Unit number 



J05 

Parameter count 

Unit number 



Required porometeis 

Parameter count Byie value = $01 

UnJi number Eyie value = SOO 

The SmartPon will perform initialization, hard resetting all devices and sending each 
their device numbers. This call may not be made to a specific unit; rathe/, it must be 
made to the SmartPon as a whole. This call may noi be executed by an application. 
Issuing this call in conjunction with Control Panel changes may relocate devices 
conirary to the ProEMDS device list Applications wishing to itsei a specific device 
should use the Comrol call with a control code of $00, 



Possible errors 

The following enot return values are possible. 

S06 BUSERR 
S28 NODRIVE 



Communications error 
No device connected 
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open 

The Open call prepares z character device Tor reading or writingH. 

Note ihaE a block device wsl] not accept ihis call, bul will recum an invalid command 

eiror (SOI). 



CMDNUM 
CMDL15T 



Parameter count 
Unit numbcf 



E^tend*d eall 

345 

Parameter count 

Unit number 



Required parameters 

Farameter cotiat Byte value = SQl 

Unit number Byie value in [he range 301 to S7E 



Possible errors 

T^c following error return vilues are possible. 
Invalid command 



SOI RADCMD 
S06 liUSERR 
S28 NODHIVE 



Communications error 
No device connected 



Close 

The Close call lells an extended character device that a sequence of read or write 
QpL-rations hia.s ended. For a printer, iJiis call could have liie effect of flushing the prim 
buffer, 

Note [hat a block device will not accepL ihis caSI, but wiU return an invalid command 
error C$0 !)_ 



CMDNUM 
CMDLIST 



Standard call 

Parameter count 
UnJt numl^er 



Ext*nd«d caEI 

i47 

Parameter count 

Unit number 
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Required parameters 

Parameter count Byte value = 301 

Ualt number Ryte value in the range SOl to S7E 



Possible errors 

The fotkiwing error return values are possible. 
BADCMD Invalid command 



SOI 

S06 BUSEIIR 

SZS NOD RIVE 



Communications error 
Mo device connecled 



Read 

The Rcid call reads the number of bytes specified by the byte count into memory The 
starting address of memory that the dau L? read into is sped Tied by ihe data buffer 
pointer, The sddress pointer references ar^ addiess within the device that the byies are 
to be read Tfom. The mcajiing of the address parameter depends on the device 
involved. Although this cail is generaJy inLended for use by character devices, a biock 
device might use this tall to read a block of nonstandard size Ca block larger chan 512 
bytes}r Jn this latter case, the address pointer is inierpreied as a block address. 



I 



Standard call 

CMDNUM SOS 

CJvlDLlST Parameter couni 

Unit number 

Data buffer pointer (Ipwbyte) 



ExtandBd cal 

Parameter count 

Unit number 

Data buffer pointer (low byte, low worcD 



Daia buffer pointer (high byEG> Data buffer pointer Chigh byte, low word) 



Byte count (low byte) 
Byte count (high byte) 
Address pointer Gow byte) 
Address pointer (mid byte) 
Address pointer (high byte^ 



Data buffer pointer (low byte, high word^ 
Data buffer pointer (high tiyte, high word) 
Byte counl Gow byte) 
Byie Count (high byte) 
Addreis pointer Cow byte, low word) 
Address pointer (high byte, low word) 
Address poinle: Clow byte, high word) 
Address poinier C high byte, high word) 
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liequired parameters 

Parameter count Byte value = $04 

Unit number 1-byte value in ihe range SOI to S7E 



Standard call 



ex1«nd»d call 



&aca buffer pointer Word poinier Cbank S00> Longword pointer 

Fo; standard c^USj this is ihe 2'byie ptjinicr id a buITer into which the data is to be 
read For ex^nded calls, the pointer is a longword specifying a buflfer in any memory 
banlt. The buffer must be large enough to accommodate the number of bytes 

requesied- 

Byte count 2-byte number 

The byte count specifics the number of bytes to be trartsferred. AJI of the current 
Implementadons of the SmartPort uUlizing the SmartPorl: Bus liave a limitation of 767 
b^les. Other peripheraJ cards supporting the SmanPort incefface may noi have this 
limitation. 



Addr^s pointer 



Slondard call 

5-b'tle address 



Ext«nd«d coil 
4-byte address 



The address is a devioe-spedfic parameter iisually specifying a source address within 
[he device. This call might be implemented with an extended block device using die 
address as a blod< address for accessing a nonstandard block. For example, such an 

impEcmcnlation allows the Apple 3-5 drive and UniDisk 3.5 drive to read 524-byte 
Macintosh blocks from 3,5-inch media. 

Possible triors 

The follDwing error return values are possible. 



s^ 


BUSERR 


Communications error 


w 


lOEFROR 


I/O error 


i23 


NO DRIVE 


No device connected 


SIB 


NOWRITE 


Disk write protected 


$2D 


BADBLOCK 


Invalid block number 


SZF 


OFFIINE 


Device off line or no disk in drive 
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Write 



The Write call wriies Lhe number of bytes spedTied by ihe byte count to tht; device 
specified by the unit numl>er. The siarting memory address Lhal Ihe data is read from 
is spGCified by the data buffer pointer. The address pointer rcfcn:nccs an address 
within lhe device where the bytes arc to be written. The meaning, of the addr£i«^ji 
parameter depends on ihc" device involved. AJthough [his call is generally intended 
for use by character devices, a block device might use Uii^ call to write a block of a 
nonstandard size Ca block la/gcr than 512 bytes) In Lhis taiter caie^ Lhe address field Ls 
interpreted as a block address. 



Standard coll 

CMDNIIM %d9 

CMDLIST Parameter cauni 

Unit number 

Data buffer pointer Gow byte) 



EKt«nd«d call 

Parameter count 

Unit number 

Data buffer pointer Oow byte, low word) 



Data buffer pciinier (high byie) Daia buffer pointer Chigh byte, low word) 



liyte cnuni Oow byte]! 
Byte count (hJijh byie) 

Addn°xs pointer Oow byte) 
Addreis poinicr tmid byte) 
Address pointer (high byte) 



Data buffer pointer Gow bytt, lugh wurd) 
Data buffer pointer (high byte, high word) 
Byte count Gow byte) 
Byte count Chijgh byie) 
Address pointer Oaw byie^ low word) 
Address pointer Chigh byte, low word) 
Address pointer (low byte, high word) 
Address pointer C high byte, high word) 



Required parameters 

Parameter ctignt Byte vaJue = J04 

Unit number 1-byte value in the range SOI to S7E 
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standard cqII 
Data buffer pointer Word pointer (bank 



Extended call 
Longword pointer 



For standard calls, Lhis Is- the 2-b>ie posnter lo a bufTer in:o which Lhc data is to be 
read. For extended calls, the pointer is a longword specifying a buffer in any memory 
bank. ITie bulTer must be large enou^ Lo accomfnc]Clat,e the number of bytes 
lecfuesied. 



Byte count 



2-byle number 



The b\le count specifies the number of hytss to be Eransferred. All rrf ihe current 
imple mental ions of the SmartPon uUli?ing ihe SmgrtPort Bus have a, limitation of 76? 
byles. Otiier peripheraJ cards supporting the SmaxiPori interface may not have this 
limitation. 



Address pointer 



Standard call 
3"byic value 



Extandvd call 

■^-byle value 



lhc address is a device-specific parameter usually specifying a destination address 
within the device, '["his call might be implemented with a block device, uiiing ih& 
address as a block address for accessing a nonstandard block. For example, such an 
implementation allows the Apple 3.5 drive and UniDi&k 3.5 drive to write SS-i-byie 
Miciniosh blocks 10 3.5-inch media. 

Possible errors 

lhc following error rettim values an? possible. 



)06 


BUSERR 


CGmmunicatfans error 


t27 


lOERROR 


I/O error 


$28 


NOD RIVE 


No device connected 


$2B 


N'OWRITE 


Di5k write protected 


i2D 


BADBLOCK 


Invalid block number 


S2F 


OFFUNE 


Device ofi" line or no disk in drive 
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Tables 7-1 and 7-5 summariic the command numbers and parameter lisis for sLandard 
and exiended SmariPort calls. 



F, 



Tab!* 7-3 

Summary of standard commands and parame+ar lists 



CommcHKl Statui BeodSlack WriEvBlock Forrnqf Conlroli Init 



Open Close Retsci 



Wfilte 



CMDLIST 
byte 



1 



$00 



$0J 
Unl 

Status 

list 

pointer 

Status 

list 

pointer 

Status 
code 



%U\ 



103 

Unit 
number 

Daia 

buffer 

pointer 

Dau 

buffer 

posmer 

Block 
number 

Block 
nujiibcr 

Block 

nl Imhnr 



toz 



SQ3 

Unit 
number 

Dala 

buffer 

pointer 

Data 

buffer 
poinicr 

Blodc 
number 

BEdcIc 
number 

Block 

nrnnhpr 



*03 



SOI 



$04 



$05 



S05 



£01 



SC6 



$01 



$07 



$01 



SOS 



$04 



509 



S04 



IJrtil Unit Unit Unit Unfl UniE Unit 

number rtumbcr nuinbcr number number number nutnbei 

ControJ 

ll£t 

pointer 

Contra I 

list 

pointer 

Conlrol 
code 



Data 

buffer 

pointer 


buffer 
pointer 


Data 

buffer 

pointer 


Dat2 

buffer 

pointer 


I3yte 

count 


nyte 


Byte 
count 


Uytc 
count 



' Thts pao'^mctcr is device specific. 

♦ Note.- [Tie Read byie counl and ihe ConLfol call list contents in some SmartPon Implementations 
may noL be larger Ihan 767 bytes. 

Upon return from the Read all, the byte count bytes wiL coniaOn Jne number of bytes actua^Hy read 
from the device. 
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p 


Tobfo 7-3 


























Sumrmofv of exiertded commands and parameter lists 














Commanti 


SlaTui 


BHdSlocli 


WritcBkick 


Format 


Control 


Inl! 


op«n 


Clof* 


R*od 


Writa 




CMDMJM 


S4D 


141 


ii2 


Hi 


$44 


$45 


S46 


$47 


$48 


H9 




CMDUST 


























tylc 





























SOB 


S03 


i03 


$01 


$03 


$01 


SOI 


SQl 


$04 


$04 




1 


Unl 


Urtli 


Unit 


Unit 


Unit 


Unit 


Unit 


Unit 


Unil 


Unt 






numtMir 


number 


number 


number 


rtufiibef 


numbef number 


numbe 


number 


number 




2 


Status 


Dana, 


Data 




Controi 








Data 


Oaia. 






lisl 


buffer 


buffer 




list 








buffet 


buffer 






pointer 


pointer 


pointer 




pointer 








pointer 


pointer 




3 


Status 


Data 


Data 




Control 








L>Sta 


[Ma 






list 


buffer 


buffer 




list 








buffer 


buffer 






pointer 


pointGT 


pointer 




pointer 








pointer 


poinier 


^H 


Status 


Data 


Data 




Control 








DaU 


Data 


^^^ 


list 


buffer 


buffer 




li5t 








buffer 


buffef 


^^H 


pointer 


pointer 


pointer 




pointer 








pointer 


pointer 


■ 


^^P ^ 


Status 


Data 


Data 




Control 








Data. 


Ola 


■ 


^^Km 


tlsi 


buffer 


buffer 




list 








buffer 


buffer 


I 


^^1 


poEnier 


pointer 


pointer 




pOintci 








pcrfnter 


pointer 


1 


^H ^ 


Status 


Btock 


Stock 




Control 








Byte 


Byte 


■ 


^^H 


code 


number 


number 




code 








count 


count ^M 


^^P 7 




Block 

number 


Block 
number 












Byte 
count 


Byte H 

count ^M 


^L ^ 




Block 

number 


Btock 
numtH^r 












« 


^^H 


^1 




BEock 


BEock 












9 


^^H 


^H ' 




number 


number 












* 


« 


1 


^^B ' This parameter is device specif 


t 












« 


* 


1 


^H ^ A'^ofg.'The Read byls count and the Control call tist ooments in . 


some SmartPorL im 


pkmcnlations iH 


^H niay not be larger than 767 bytes. 














■ 


^B| upon ictum from the Read call, ihe byi£ 


: count bytes will 


COntaiA 


[he number of bytes actually read || 


^HP From the device 






















1 
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SmartPort calls 
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H 


^^^1 


^^1 


^^H 


^^^1 


^H 


^^1 


^M 


^^H 


^H 


^^1 


^^^^^^H 



Device-specific SmartPort calls 

In addilion la Lhe CGmmnn command sel of SmartPorl calts already listed, a device 
may implement its own device-spcdfic calls. Usually, these caHs are implemenled as a 
-subset of lhe SmanPort Status or Control call rather than as new commands. 



SmartPort calls specific to Apple 3.5 dlslc drive 

Seven Apple 3.5 drive device-specific caUs are provided as CJttensions to ihe Conirol 
call, These devtoe-specific control calls may be used only with lhe AppEc 3.5 drive. To 
dcicrmine whether a device is an Apple 3 5 diive, examine the lype and subtype bytes 
returned from a DiB status call. iFihe type byic Li returned with a value of , SOI and the 
sublype byte is returned with s value of SCO, then the device is an Apple 3.5 drive. 
because devitc-specinc calls to the Apple 35 drive are implemented as Control calls, 
only the conirol code and control lisi for these calls are defined here. Refer to lhe 
SmartPort ConUol Call section eariier in this chapter Tor information about the 
command hytt and parameter lisi- 

The following information about Eject and SetHook should be treated as an extension 
10 the extended SmartPort Control call. 



Eject 

Ejtct ejects the media from a 3.5-inch drive. 
Ccntrol codo Controli ua 



504 



Count low byte 
Count high byte 



V 

H< 
n 

S' 
$ 
S 
S 

$ 



SetHook 

IsetUook redirects routines internal to the Apple 3-5 drive. Ttte routine to be 
redirected is referenced by lhe hook reference number. The address dial the routine is 
to be redirected to is spediied by the 3-byte address field in tlie control Ks;. 



Control cDd» 


Control lilt 




505 


Count low byte 


$04 




Count high byte 


SQO 




Hook reference number 


$xx 




Address low 


Sxx 




Address high 


Sxx 




Address bank 


ixx 
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Valid hook reference numbers and their associated roulines are as follows: 



Jiacli 




rtferBmce 


SDut]n« 


ioi 


Read Address Field 


J02 


i^ead Data Field 


J03 


Write D3[a Field 


m 


Seek 


S05 


Format Disk 


£06 


Write '['rack 


m 


Verify Track 



Read Address Flefd 

TIk Kead Address Field routine reads bytes from the disk until ft finds the address 
marks and s sector number specified as inpul parameLers for ibe routine, 7^e fcad 
Data Field routine taads a 52'i'byK! Macintcxsh block or 512-byifi Apple II blade from 
^ disk. 



Write Data Field 

The Write- Dat^ Field routine wriijes a 524-biyCe block of daia lo ihe disk, For Apple n 
bEocks, the first 12 bytes will be written as aero. 



The Seek fcuiine positions the read and wriie head over the appropriate cylinder on 

[lie disk. 



r 



Format 

[he h'ormat routine writes address marks, data marks, zeroed data blocks, checksum, 
and end-of-block marks. 



Write Track 

Tlie Write Track routinie Is called by the formatter to write one track of empty blocks. 
■|lie number of blocks written depends on the Irack that the read and write head is 
positioned over. 
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Figure 7-B demonstrates the physical layout oF ihe format that this command writes. 



Address 
majki 




Address field 




Gq3 




Dato 




Data fl^d 




Eoa 

markf 


1 












e 
















■-^ 1 


F 








D5 


AA 


96 


U 






¥■ 


□ 
E 


ZJ 




Q. 
in 


U. 


5-10 bytes sync 


D5 


AA 


AD 


5 

en 


3^2 data bvtas 


3 
O 

U 


D.E 


AA 


ff 



FJguia 7-fi 
D|i!<-sector Tormat 



Verify 

The Verify rouUne is caEled by the fannatter to verify ihai ^e daLa wriiten by the Write 
Track fDutlne was written correctly. 



ResetHook 

RcsetHgok restores the default address for ihe hook BpecLfjed in the control list. 



Control cad« 
S06 


Count low byte 

Count high byte 

Hook reference number 


SOI 



SetMark 

SeLMark changes Individual byles in the mark tables. The count Held specilies the 
number of bytes in the mark table to be written plus 1. The siajt byte references an 
Qffeet i(VU) Lhe milk table to "wbich vhe ww bytes are lo be vmtten. Boufi<is checking is 
performed to mike sure the byte count does not oveiilow the irmemal mark table 



Control cod« 


Cantrol Hrt 




507 


Count low byte 


%-KX 




Count high byie 


soo 




Sort byte 


%xx 




Data 





Th* 

Vol 

$F] 
Si 

*A 

$D 
SFI 
SF 
$F 
$C 
S3 
$F 
$F 

Re 
fie 
dc 

$C 



SI 

5i 



s 

s 
c 
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The default values for the Mark table ire as follows; 



Vdu» Bvt« numbor 



Vduv Byte numb«r 



JFF 


secCor number 


SAA 


11 


$AD 


1 <h.iA marks 


5DE 


12 


3AA 


1 


JFF 


13 


$D5 


3 


3FF 


14 iiuerheadcr gap 


JFF 


4 


5FF 


15 


JFC 


5svnei?>tes 


$FF 


16 


m 


6 


4PP 


17 


JCF 


7 


$96 


18 address marks 


«F 


8 


SAA 


19 


$FF 


9 


SD5 


20 


iFF 


10 biE-slip marks 


SFF 


21 


BesetMark 







ResetMark restores individual bftes In the mark ubles to the default values. The count 
Geld deTines the number of byies In the nark table lo be restored plus 1 The stait field 
defines where in the mark table the bytes are to be reslored. 



Conrrol cod* ConUal lltl 

SOB Count low byte $xx^ 

Count high byte $00 

Start byte Sxk 



Sets Ides 

SetSi<fes sets the number of sides of the media to be formatted by ihe Formal call. It 
supports both single-sided and doubie-sided media. If" the most significint bit of the 
nombef of sides field is sel lo 1, then double-sided media are formatted. If the most 
sienificani bit is cleared to 0, then single-sided media are formalled. 



Cortrat code Control list 

5CJ9 Count low byte $Q4 

Count high byte SOO 

Number of sides Snn 



Setlnter leave 

Seilnlerleave sets the sector interleave lo be layed down on the disk by the Format call. 

Control co<l« Conirot lltt 

SOA Count low byte SOQ 



CounE liigh byte 
Interleave 



SOQ 

501 to SOC 
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SmortPort calls specific to UniDisk 3.5 

Five UniDisk 3,5 device-specific calls arc provided as exiensions lo ihe Conirol and 
Status calls. Tliese devke-s-pedfEC calls may be used only wilh ihc UnLDisk 3,5, To 
deLermsne whether a device L^ a UniDisk 3,5, e>;am!ne Lhe type and subtype bytes 
returned from a DIR slatys call. 11" the type byte is ictumed with a value of SOI and the 
subtype byte is. iCEumed with a value of" $00, then the device is a UniDisk ^.5. Only the 
control code and contfoE iiet are defined for call* here implernented as extensions to 
the Conirc;! call. For calls implemented as cxlcnsions eo Ihc Staius call, only the status 
code and status list are defined Refer [o the sections discussing Lhe SmarLPort ConLrol 
and Status calls earlier in this chapter for more information about these calls. 



Eiect 

Eject ejects the media from a 3-5-inch drive. 

■CoFiliQl cod« Conlfol Nil' 

$04 Count law byic $00 



Count law byic 
Count high byte 



SOO 



Execute 

Execule dispatches the intelligent controller in the UniDisk 3.5 device to execute i 
65C02 subroutine. The register setup is pa^^%d to liie routine to be executed from the 

control list. 



CDn.iiol code 


Conirol lls^ 




505 


Count low byte 


$06 




Count high byte 


$00 




Accumulator value 


$.>oc 




X register value 


$xx 




Y register value 


$rat 




Processor status value 


3 EX 




Low progrann counter 


53tX 




Fligh program counter 


Sxx 
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SetAddress 

SeL\ddfeM sets the address in the UniDisk J.? conLroJkr memorv ."ipacc into which the 
Download call loads a 65C02 rouiiae. The download address must be set to free space 
in the UniDisk 3^ memory map_ 

Cnnlral cari> Conlrol Elsl 

i06 Count low byte S02 

Count high byie SOO 

Low byte address $xx 

High byte address 5xx 



Download 

Download downloads an executable 65CQ2. rauLine into Lhe memony resident in the 
UnEDEsk 3.5 coniroSler, The address that the routine is loaded into Ls set by lhe 
SelAddrcss call. The count field must be sel to the length of lhe 65C02 routine to be 
downSoaded. 



Control cod* ConifDl list 

J07 Count low byte 

Count high byie 
Executable 65C02 routine 



$JtX 



UnlDl^kStot 

UnsDiskSui allows an application to get more inrormation about an error that occurs 
during a read or write operation. It also allows an application to access Ehe 65C02 

register slaite after dispatching the UniDisk 3.5 conlroller to execute a 65C02 routine via 

the Execute call. 

Memory-mapped I/O addresses internal to the UniDisk 3.5 controller are shown in 
Figure 7-9 and Tables 7-4 and 7-5. 



Status cod* 


Stalus tilt 




S05 


Byte 


SQ4 




Soft error 


SOO 




'Retries 


txx. 




Byte 


$00 




A register after execute 


Ssrx 




X register after execute 


%xx 




P register after execute 


$xx 



SmartPoit calls specific to UniDisk 3.5 
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UniDisk 3.5 Internal functions 

Copy proieciing 3 UniDisk 5.5 is more complicated than protecting a Disk 1] because 

the 3.5-inch disk has its own conlroller. 'iTie drive inetf (beyond Lhe small 65002 
system that controls ii) is somewhat inLeHigent; performiJig such operaiions as 
sLepping the drive 10 a half track is not possible with lhe doublc-sidcd Sony disk. 

The design of lhe UniDisk J.5 firmware, however, affords the copj/- prelection 
engineer (CPE) tools wiih which to alter the data nn Lhe disk suffidenily to make 
copying very difiicult. In all cases, code or other information i^ downloaded to the 
coniroller's on-board RAM, The firmware provides s defined method for setting 
RAMh but not for reading it; this increases the difficulty oF lhe copy-protection buster's 
job. Infomiaiion downloading is accornpltshed ustng the Set_Down_Adr and the 
DownLoad commands, deiailed in the SmartPori documentation. 

Funher, njnning nibble-copy programs with the UniDisk 3,5 is difficult to do. Nibble- 
copy programs typically dump an entire track into memory and then try to make sense 
of what they have resd and duplicate the data stream. The L'niDisk 3.5 controller 
contains only 2K of RAM, and ihis iimitaiion makes track dumping and copying 
extremely difilpjlt. A track would have to be dumped in 1 or 2K pieces, and then the 
pieces would have to be correctly reassembled, proces.sed in host memory, and 
somehow wriiten In 1 or 2K pieces to die targei disk. Give dJficulty of creating a 
reasonable bii copier means that elaborate copy-prolection measures may no^ be 
necessary and that relatively simple techniques, such as simpty changing marks, will 
suffice.) 




Mark table 



All address and data marks used by lhe BdAddr, ReadData, WriteData. and Format 
routines are Jocated in page z^ro. The foJowing details the table values and their 
fLmciions (noie that these tables are all reversed from the order in whidi they appear 
an [he disk): 



FLncllsn 


Addre&s 


D«rault value 


Data marks 


S008E 


SAD, $AA, $D5 


Data-sync marks 


50091 


iFF, 3FC, SF3. $CF. S3F, $FF 


Bit-slip marks 


50097 


iFF, iAA, SDE 


Address marks 


S0O5F 


$96, 5AA, $D5 



The CPE can alter the values En this table and format a disk with the new marks, and 
read and write operations wDl recosnize sectors with these new mark.-;, 
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The CPE must, however, be carePul when changing ihe marks, The address, data, and 
bi[-slip marks were chosen so that no bytes in the usct'H' encoded data could be 
mJsEaken for them, and the CPE shouEd consider this when changing the marks. 
Probably Lhe safest marks to allef are Lhe bit-slip marks because ihe Hrmware never 
uses these to try to find a field, they are simply double checks to ensure ihat 

S^mchrpni zalion vj^s maintained during 3. read npetalitin. 

Tile dala-sync maiks could conceivably be altered and some identifying mark used 
instead. The CPE should be aware, however, ihat ihl^ Held is pai^ally rewritten every 
time the block is written and that whatever maiks arc there must guarantee the 
aynchronization of lhe IWM so ihaL Lhe first data-field mark (normally 5D5) can be 
read. 



Hook tobte 

%ch majcpir disk-acces5 rtHjtirie has a JMP instmciion to jump through a hook in zero 
page. Hooks in these routines are collected in a section of 2cro page known as the hook 
table, tach hook is a 3-byle 65C02 JMP instruction that veaors to lhe corresponding 
Pcnjline. This allows [he CPE in install routines to taJte the place of ones mich 3S RdAddr 
iiid ReadData. Because the hooks are reset when power up occurs or a resei control 
ca]l is issued, ^e CPE may preserve the "default" address in a hook, point lhe hook at 
hii or her own routine, and lihen have this new roulinc^ end by jumping to the old 
routine, 'llus in effect allows the CPE to insert tn his or her own code at strategic points 
in the disk read and write processes. 

The CPE must ensure that any code installed in place of a routine emulates the 
behavior of the code it replaces. The functiDnal and flag return specifications for the 

itiuUne must be obeyed; otherwise, higher-level routines will become confiised. The 
'hookable" routines are as follows: 

Addjsii Vector Routhe function 

50072 RdAddr Find and decode an address field 

SO075 EeadData Find and load a data field into KAM 

S007S WriteData Write data-sync field marks, data, bit-slip marks 

iO07B Seek Turn tnotor on and seek the specified track 

S007E Formal Write address and data fiekls (all zeros) 

i(308l WrileTrk Seek licad and write track full of sectors 

$0084 Verify Verily the integrity of an entire track 

J0OB7 Vector Dispatch a command received from the host 

Specifications for each of these routines follow. Note that you will be able to use these 
lunctions more effectively if you understand the 3.5-inich disk data formal. 

iTfhen bits of bytes arc specified, they arc numbered 765-^3210 and enclosed in 
Ibrackcts [ ]. Also, no^e that lhe conirolEer supports two drives Cdrive and drive l), 
leven though all UniDisks 3.5 usa a single-drive config-uralion (drive only). 
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UnlDisk 3.5 internal routines 



IW^ddr 

Find and decode an address field. 



Output 



Carry set on Umeout, checksum^ or bit-slip error; clear otherwise. 

Sectlnfo. (5 byte&) 3t J0027 (if any dear). 

On error: i0O57t5J is sei, meaning Address error. 

None, A, X, Y are not preserved. 



Register 

requfrcmeats 

This iouiine wails for ihe /RFADY line to go low and then waits Tor an address field to 
spin by, A timeout of aJmoa two sector limes is allowed If no address mark Is found 
during this period, or if the data in ihc address (leld has a bad chedtsijm, or if ihe bll- 
siip bytes are wrong, Ihe routine returns with the cany flag set If the cajrry flag is set, 
then the status byte has the address error bit seL If a good address field was read, its 
conienu are denibbLzed and the results left tn $27-i2B In reverse order JTrom die way 
they appear on [be disk. 



i 



ReadDafa 

Find and load a data field into RAM. 



Output 



Carry set if timcoyt, checksum, or hit-slip error; clear otherwise. 

Data read into buffers at SlCO, i640, and |740. 

On error: 30057B3 set for bit slip^ (41 set for checksum error. 



Regtster 

requirements None. A, X, Y are not preserved. 

This routine searches for msrks identifying a. data field- This rtxiline is called 
immediately after a suoiesslul call lo RdAddr; therefore, the limeout is eKiremely 
short (25 bytes) After a data field mark is found, the next byte is dcnibbli^ed and 
checked to see if it has ihe correct sector number, and an error ia returned if it does 
noi. If the header is all right, die daia is read, decoded on the fly, and piiced in the 
three data buffers in reverse order. The bit-stip marks are checked, and an error is 
generated if they are not ai expected. If an error occurs, the status byie $0057 is set lo 
indicate ihe type of error encoiintcrcd. 
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WrifeDora 

WfitE daiasync field, ni^rks, data, bit-slip mark^. 

Input Data in buffers at 3100. S6^0, and S740: checksum. 

Re^ster 

requirements None. A, X, Y are noi preserved. 

This routine is called just after Ild/\ddr has found the correct address field, U writes oul 
the data-sync field, 1-he daU markj?, die nibblized sectnr number, die data, and iIil: biL- 
slip marks. At this point, checksumuiing and pump priming will already have been 
peribrmed by the WritePrep routine. 



Seek 

Turn motor on and seek the si 



track. 



Input 



Output 



Cyl (S!4>; new cj'lindcr <$O0-S'lF) to seek- 

Drive {£13>; drive currently selected. 

CuitCyl (SOD, JOE); cylinder where each head initially rests. 

Carry set if seek error, dear otherwise. 
CurNSect ($1A): nurnber of sectors this cylinder. 
On error: 50D57[I] set for seek error. 

[sier 
requirements None. A, X, ¥ are not pfeserved 

[irCurCyll?] for ihis drive is set, ihe routine recalibrates the head. The motor is turned 
on. the stepping dixeclion Ls set, and the correct numhsy^ of step pulses is issued. 



i 



Format 

Write address and data fields (all zeros). 
Input 



Output 



Drive ($13); drive currently selected, 

FormSides ($63); formal a dauble-sided disk (SSOy 

Carry set if error; clear otherwise. 
On error: S005E ha5 SA7 trror code. 



Register 

requirements NonCr A, X, Y are not preserved 

The formaUer turns on the: motor and checks whedier a wn'te-enabled disk is in [he 
drive. If one is, a sector image is generated and WriteTrk ts called. T^en Verify is 
called; if verification fails, up lo 10 retries are attempted. IfFormSides is seL to double 
sided CSSO), bodi heads arc formatted before the head is stepped to the next track. 

UnlDisk 3.5 Internal routines 
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WriteTrk 

Seek head and write track fuL of sectors, 

lAput Drive C$13): drive currcnily selected. 

Cyl (S14); cylinder to formal 
Side ($16): head number. 

FormSides CS633: format a double-sided disk CS80). 
IfLCerleave (J62): set physical interleave. 

Register 

requirements None, A, X, Y are not pieserred. 

This routine seeks the head GF necessary), writes a large group of sync marks (lo 
guarantee the eniire track), and then writer the appropriate number of seclors with the 
correct interleave. 



Verify die integrity of an entire track. 

Input CurNSecL ($3A^: number of seaors [his cyiinder. 

Output Carry set if error; clear otherwise. 

On erron S0057 bits sre set specifying error. 

Register 

requirements None. A, X, Y are not preserved 

this rcHiiine uses RdAddr and ReadData in verify that all sectors on the crack are all 
right, Lhat sectors aje unique and that the data fields can be read without error. 
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Vector 

Dispaich a command received from che host. 

Input CmdTab (SdC.,$54); command from SmartPort. 



Output 



SlatusTab (536..S5E>: sec to SOO. 

SlalSyte <$5E); $B0 for no error; error code otherwise. 



Register 

requirements None A, X, Y are nai preserved. 

This fouiine looks in ihe command table, checks ihe vaiidiEy of the command code 

ind parameter count, turns on the drive specified, and jumps to the rouiine ihai 
services the Eype of command speciTied, U also sets up the default paj-ametere for the 

cornmuni cation routines. If an error is detected in the parameter count or command 
code, d\e status byte is set appropriaiely. The command table looks like this: 

CMDTab 

CMDPCount 
CMDRemain 

The contents of the last 7 byies depend on the call type, They are the bytes after the 
unit nunJDer in the SmartPort command list 



DFB 


Command_Code 


;0 ■ Status, 1 = read, etc. 


DFB 


Parameter Count 


;Logica] count for this command 


DS 


0,7 


iCall specific 



UnlDEsk 3,5 Interrxal roLrtlnes 
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Memory alfoQation 

The rirmware does not use page 5 of RAM or ihe lop 64 byies of the zero pa^- The CPE 
IS free t« iitstatl patdie* and other code in S05n0-SO5FF and IfeOOCO-SDOFF. Figure 7-9 
shows the entiie UniDisk 3.5 memory map as well as Hmiwaie RAM apacs use. 



Memory layout 



SFFFE 




St two 



3D AGO 



$oflaa 



M RC:.. 



UnlmplomentBd 



IWM reglEtefS 



.../.■ .- . 
GaTB array I/O 



BAM layour 



/ 



/ 



Fl'mwarfi RW buffof #3 



FirmwQte RW buffer #2 



Free space 



/ 




farmat sector tuftsf II 



Hoif commLinJcaflQn buffor" 
Format lecror auffef i 



isoeoa 



SOAOO 



sosoa 



3040 G 



65C02 s'acir area 



Flrmwora I3W buffer #■! 



roo zoro pOQ& stJfice 



C!^ 



Firmware imo page 



SOIOO 

snoco 

SO 000 



1 



50002 



Figurs 7? 

LfnOlsk 3.5 memory mop 
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Table 7-4 






■ 




UrIDisk 3.5 


QQte airay I/O locations 




1 


Function 


dala4 dataS 


dalQ2 da^g] cFataO 


Read SBOO 


LASTONE/ BUSEN/ 


WHTiEQ /GATEN3L HD5EL 




Wrt $800 


TRIGGER ENBUS 


PH3EN IWMDIB HDSEL 


^1 




Read S801 


StNSE BLATCHl 


BLATGH2 URONEN CAO 


H 




WftSSO] 


/RSTIWM /BLATCH 


/BLATCH DRIVEl DRIVE2 


H 


|i 


■ TabiB ?-S 


CLRl 


CLR2 


1 


1 


UniDlsk 3,5 IWM locations 




1 


Lecallon 


5p*elflc kitMl 


IWMDie a (drvl IWMDia - 1 Ehost) 


$0AOQ 


PHASED resei 


CAO re?e[ /BSY handshaJte 


^B 


iOAOl 


PHASED set 


CAO set /BSY handshake 


^1 


^H 


$0AO2 


PtlASE] reset 


CAl reset 


^1 


^B 


$0AO3 


PHASFJ set 


CAi set 


^1 


^H 


iOA04 


PHASES reset 


CA2 reset 


i^H 


H[ 


S0AO5 


PHASE2 set 


CAZsei 




■ 


^^ 


50A06 


PHASE3 reset 


LSTRB resei 




■ 


^B 


50A07 


PHASE3 set 


LSTRH set 


■ 


^H 


SOA08 


MOTOROFF 




■ 


^M 


$OA09 


MOTORON 




■ 


^D 


jOAOA 


ENABLEl 




■ 


^■f 


ftr, • yiti 


DB ■.4.ni.:|qa' 




■ 


^B 


SOAOC 


L6 reset 




■ 


^1' 


lOAOD 


L6 5Gt 




■ 


^p 


SOAOE 


L7 reset 






■ 




SOAOF 


L7seC 














.Memory albcatlon 


1 




^^^^^^H 


^^^^^^^^^^^^^^^^^^1 


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^M 


^^^^^^^^^^^M 


^H 


^^^^H 


^^^^^^^^^^^^^1 


^^^^^^^^^^^^^^^^^^^^^^^H 


^^^^^^^^1 



ROM disk driver 

The ROM disk is a pluB^"^ c*^*J i^^ houses ROM ihai may be organized into blocks to 
emulait;: a disk device of provide space for ROM ba.wd programs. Although the 
SmartPort has no buili-in ROM disk, SmariPort does support an CKtcrnal ROM disk 

driver. 



Installing a ROM disk driver 

The driver for a ROM disk musi reside at address SH)/O0O0. The ROM disk may occupy 
only ihe address space from $FO/000O ihrough $K7/KFf"H, The base address of the 
driver must contain the ASCII string ROMDISK in uppercase letters with the most 
signifiCJjit bit on. Entry lo ihe ROM disk driver is through address $F0/(XX)7. The 
SmartPort firmware will search for a ROM disk driver during the boot process while 
a^ssigning unit number* to each of the SmariPort devices. IF ihe SmariPon finds the 
ASCII string ROMDISK at address 3F0/O007, ii exccutts an InitiaJiation call to the 
ROM disk driver via the ROM disk entty point. If the ROM disk relums wich no CiTor, 
the KOM disk driver is Installed in the SmariPnrt device diaJn. If the ROM disk 
Initialisation call returns an error, the ROM disk driver is not installed in ihe SmartPori 
device chain. Note that the ROM disk driver is called via a JSL instruction in 8-bit 
native mode. 



Passing pcra meters lo a ROM disk 

Call parameter are passed to the ROM disk from the SmartPort through fixed memory 
locations in absolute 2(tro page. All input to device -specific ddvers is passed in an 
extended format, even for standard SmanPon calls, so ihai ihe call p2rametcrs can 
always be found iri Hxied IcKaiions. Note that standard calls are not changed into 
extended calls- only parameter organization is. affected. 

Some parameters do not occupy contiguous memory when ihey are presented in an 
extended formal because the order of parameier? has been prepared so the 
parameters can be iransmiited over the SmartPort hu.^ to intelligent devices. Absolute 
2ero page locations J-fO to 62 are saved by the SmartPort prior to thesr dispalch lo the 
ROM disk and are restored by ihe SmatiPori after iheir return from the driver. Thus, 
these locations are available for use by the ROM disk driver. 
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'I 


1 

^ Call parameters are passed to the ROM disk driver as foUows: ^H 




iKrnHon ParamaioTK Cell Iyp4 i^^| 




£42 Buffer address (bits to 7) All ^M 




M5 Buffer address <bH£ 8 ta 15) All IH 


^B M4 Bufter address <h'iis l6 ta 23> All ;^| 




i45 Command All '>^| 




S46 Parameter count All ';^| 




(47 BufFer address (bits 24 lo 31) All ^M 




y; J4a Extended block (bia to 7> ResdBlock and WriceBlodt ^| 




I Status code or control code Status and Cantrol '^^H 




F Byle counl (biLs lo 7) Read and Write |^H 




h W Extended block (bits ^ Ld 15) ReadBlock ^nd WriteBlodc !^| 




I Byte count [bits 8 tol^> Read and Write '^M 




1 S4A Csicridcd block CbiK 16 lo 23) ReadBlock and WnieBlock '^M 




W Address pointer Cbrts to 7) Read and Write ^H 




1 S4B ExiendedblockCbi[s 24 lo 31) ReadBlock and Write Block WM 




AddrGiS poimer C^jits fi to 15) Read and Wriie TB 




S4C Address poinler (bits l6 lo 23) Read and Write « Jl 




S^D Addre'^.s ptiimer (bits 24 lo 51) Read and Write WM 




Pirameiers returned to the application from the KOM disk driver are passed in ffl 


^^M ibsolute 2eTo page locaiioiis as foMows: ■ 


^H^ tocGiiofi ouipuF poram«^r potMct ■ 




1 S0Q0O5O Error code 




r S00OO51 Low byte tifooum of bytes transFetred CO host 




1 5OD00S2 High byte of count of bytes trajisfcired lo host ii. 




II 
All I/O infomnaLion passed between the application making the SniaitPon. call and the 




BOM disk driver is passed through the buffer specified in ihe parameter list, 

/ 

! 

1 




1 ' „.„,.] 





ROM orgonlzaHon 

ROM for a. ROM disk must contain the ROM disk signature siring as well as a ROM disk 
driver A map of the ROM address space when portions of ROM are organized as 
blocks is shown In Figure 7-10. 



• • 


* • 


1 


k • 




(!OM dEk blocks 


SFn/XXXX+1 




SFn/XXXX 






ROM dl* driver 


SPOOOD? 




$F000O0 


ACSIt sTrlna 'ROMDISK' 


Figura 7'10 

The ROM disk 
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I 1 

A block diagram of a ROM disk that occupies l2fiK of ROM (induding the driver itself) ^H 
is shown in Figure 7-1 1 . Noie thai no ROM space has been reserved for Loolset ^M 
fitpan^ion in Lhis example. ,^^| 






Block SFE H 
Block SFD H 
Block SFC ■ 






I 


t 1 








Block 5B3 H 
Block 3e2 H 

Block 5B1 ■ 
Block S&D ■ 
Block S7F ■ 
Block $7E H 
B^OCk S7D ^1 
BEOCM £7C ■ 


















4 

Total number of blocks = ROM size ' 


1 1 
■ ) 


^1 






BiOCk S13 H 
Block S12 ■ 
Block £11 ■ 
Block SIQ H 
Block: SOF H 
Block SOE H 
Block SOD ^1 
Block $0C H 
Block 506 ^M 
Block SOA ■ 
Block S09 ^M 
BEock $06 H 
Block SD7 ^H 
BiOCk £0& H 
eiQch SOS ^1 
BlOCH £04 ^M 
Bloch 503 ^1 
Block £02 ■ 
BiQCk 501 ^1 








































Slock SOO 


^M 


[>t}VBf In basG 512 bytg Wock 


^ 


^ ~ -. 


H 


or ROM bank SFD 
$\auia T'1 1 


^^^^^^^^1 SgnatuTe bytes 


1 


&tock diagram of a 12SK UOM disk 


ROM disk driver 


1 


^■^^^^^^^^H 


^^^^^^^^^^^^^^^^^^^^^H 



Summaiy of Smai+Por! error codes 

SmartPoit error codes are summarized in Table 7-6. 



Table 7-6 

SmartPort 



error codss 



Ace VQlLA Errcjr typ* 



D*tCfrp1)on 



$00 


No error 


$01 


BADCMD 


S04 


BADFCNT 


$06 


BUSERR 


in 


BAD UNIT 


$tF 


NOINT 


$21 


BADCTL 


SZZ 


BADCTLPAKM 


$27 


lOERROR 


$28 


NODRIVE 


S2B 


NOWRITE 


$2D 


BADBLOCK 


$2E 


DI3KSW 


$2F 


OFFUNE 


S30-S3F 


DEVSPEC 


S4Q-S4F 


RESERVED 


S5Q-S5F 


NONFATAL 


$60-J(SF 


NONFATAL 



No error occuircd- 

A nonexistent command was issued. 

A bad caU paramerer count was given. This error 
occurs onSy when Lhe call parameter list is not 
properly constnjcted. 

A communications error occurred in the IWM. 

An Invaliid unil numbe:r was given. 

Internjpl devices are not supported. 

The conirol or sLatus code Is not supptojied by ibe 
device. 

The control list contains invalid information. 

The device encounsered an I/O error. 

The device is not connected- This error can occur if 
the device is not connected but itfi comroUer is. 

The device is write protected, 

Tlie block number is not present on the device. 

Media has been swapped (extended calls only). 

The device is off line or no disk is in drive. 

Tliese are device-specinc error codes. 

Reserved for future use. 

A device-specific soft error occurred. The operation 
was completed successfully, bui an abnormal 

condition was detecEed. 

These errors are lhe same as the errors in the 520-312F 
range. Bit 6 indicates a soft error. 
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TTie SmarlPort bus 

The iinianPort bu5 is a daisy chain configuration of Intelligent devices, sometimes 
called bus restdetits, cnnnected to the disk port of the hosi CPU. A Disk 11 device may 
be physically connected to ihe end of the SmanPori device chain on the Apple IIGS, 
and tl5 operation will be uansparenl to the host fiimware. The Disk II device is 
dormant when a SmartPort bus resident is addressed, llie number of bus residenis lliac 
■can be supported is limited by supply-power and rWM-drive considerations. AJthough 
iJie software supports up lo 127 bus residents, power requirements usually liimii the 
maiimurn numtief of fEsidents to 4. 

Drive selection is performed thrcugli the nrmware. The command aring contains a 
byte specifying the device to be accessed. These device ID bytes are assigned by the 
SmarlPort at bus reset 

Two functions are strictly hardwire invoked: bus reset and bus enable. Doth of diese 

f nnHiti nrm qm invnUfH ThmitEih r'^mhinmrinns ctf nhflv^ hne'i nn the disk norl rha:t 

jievct occui under normal Disk H operation [Both runcilons involve in,voking 
opposing phases, which is poititle&i on a Disk II.} This allows a Disk II device and oliier 
bus re-sidcnls to stay out of each other^s way. TTie bus reset and enable fiancUons are 
aimmarized below, 

1 X 

Q 1 

The state of the PUO line during the enable function can be either a 1 or a becaiise 
PHO is used as a REQ handshake line cycled on a packet basis when the bus is enabled- 
ACK is sensed from the device through the IWM wriie-proiect sense status. 



Eunctien 


PH3 


PV 


Enable 
Kcsct 


1 




X 

1 



How SmcartPort assigns unit numbers 

Ihe assignment of unit numbers is initiated by execudng a call to the slot 5 boot entry 
poifiL '[his assignment always begins with a bus reseu The reset fliips a latch on all bus 
residents, which causes the daisy-chained phase 3 line to become low. This makes all 
(Uisv'chained devices incapable of receiving the bus-enable signal, which requires 
se i to be high. 



The hos! then sends the ID dcRnition command ^lienever a device receives Ihts 
command Cwtth Enable!), It assigns the unit nutnber embedded in the command string 
ai i[s Own uni[ number. Thereafter it will not respond [o any cnminand suirLg with a 
unit number other than that given it in the ID dfifinitlon command, 



The SmartPort bus 



T57 



Upon completing the ID dcfiniiion command, the bus resident reenables Lhe phajse 3 
line, allowing the nexi resident to receive lis ID definition command. This process 
continues so long as ihere are bus residcnii^. The last bus fcsiident in lhe device chain 
returns an excepiion, indicating thai lE is the last bus resident. 

AJthough Disk n devices are connected lo Lhe disk port, they are not bus residents and 

do nnt respond to the ID definition command, A resident determines thai it is the last 
intelligent device in the chain by sensing a signat. nortnally unused in Disk n 
operations, which is grounded by ad intelligent devices. If no bus resident or Disk n 
device is daisy chained to the port, the phase 3 line is read as high. 



SmartPort-DiskJI fntaracfion 

The disk port built into lhe Apple IIGS iiupporis daisy-chained 5.25-indi diski OJmDisk 
5.25, Disk JI, or DuoDisk) by sharing the same disk port hardware between two 
diiTerent ROM slui areas. The slot 5 ROM area comains the SmarlPurl interface and 
ProDOS block device driver, and the .slot 6 ROM arta conuins the Disk 11 interrace. 
lhe Disk 11 device is enabled by the disk port signal /ENABLE2, The SmanPort musl 
aciivaie the /ENABLE2 line to communicate witli intelligeni bus residents, ffthis lint 
were not iniercepted before being passed to daisy-chained devices, any attempt to talk 
lo devioes on the bus would rciult in spurious operation of the Disk II ai the end of the 
chafn. 

For the Disk II to remain aloof frx;m SmartPon aciivity, each resident must gate [he 
/ENABLE2 line so that whenever any SmanPort bus residenl is enabled (PSJASE] and 
PHA3F5>, any Disk 13 at the end cjf the chain is disabled. In other words, tlic 
/E>]ABLE2 line is passed to daisy-chained devices only when either PHASEi or 
PHASES t? low; 



BUS ENABtE (PHI and PHD 

PHASKl-O or PHASE3=0 
PHASEl-1 and PHASE3^1 



/ENABL?2 (doliy chalnsd) 

/ENABLE 2 
Deasserted (high) 



Ofher consideitlttons 

All intelliKent residents uy to process every command packet sent over the bus; a 
resident responding only if Ei recognizes its own ID. lype, and subtype encoded in [he 
packel. lhe device type and command are used by the device to arbitrate between 
extended and standard packets. Thus, one rtsideni can tell when some otheT resident 
is being accessed or if the packet type fextended or standard) is compatible wiih the 
device, A device tontroiler can iherefore reduce its power consumption when it is not 
being consiandy accessed. 
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Extended and standard command packets 

The ntimbej- of bytes passed over the SmaitPort bus iji a standard cammand packet is 
itesame as the numbef contained tn an exiended command packet Standard 
SmirtPon. command pars-meter lisis can consist of up lo 9 bytes. Extended SmartPoit 
command pajameter lists can consist of up to 11 b>nes. The command packet was 
designed for a maximum of 9 byifis of ififomiaLion. The First 2 bytes aSways contain die 
SmifLport command number and parameter count. 'ITie remaining 7 byits consisi of 7 
bytes of the parametcf list starting with the third byte for standard commands or the 
TiMi byte for extended commandi, 7 byles from the parameter list always are copied 
ifHo ihe command packet, even though the parameter list for the current command 
fiBy consist of fewer than 7 bytes. 



SmortPort bus flow of operations 

The gigneral (low of control in the SmariPoii is illusiraied in Figure 7-12. 



PtoDOS IntarfGce 



Pocket monogement 



J- 



pisk port 



■ SmqrtPorT bus 



STiartPort tnte'foc© 



Rguro 7-12 

SmartPort contifol Flow 

whenever a call is made to the SmanJ'ort device driver that uses ihe SmartPort bus, 
ilK command table sent to ihe device driver is converted into a command packet 
before being sent to [he devECC. The results of the call are al.so sent back from the 
device in a packet. All data sent over die bus ts placed tn these packets. 

* Noi€; i^ch byte of the packet Is a 7-bit quantity Cbii 7 is always set), a iLmitation 
imposed by the IWM. All data sent is converted from S-bit quantities to 7-bit 
quantities before transmission. 

The Information of the packet can be broken down into the foUowing categoritS: 
a general overhead 
a source and destination IDs 
n content? type and auxiliary (aux) type 
□ contents status 
:n contents 
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The identifiers art; 7-hii quanlities assigned scquentiaEly according to the device's 
position in ihe chain_ The ho*l is always ID=0. Because cvtry byit: in ihe pacl^ei has [Jie 
most significani bii ssi, the host is $80, the fii^i device in the chain is $81. and so on, 

TTie contents type consists of a type and aux lype byte Three contents types are 
currcnily defined: Type - Sao L^ s mmmand packet, type = SSI is a siaius packet, and 
type = S82 is a data packet. Bit-6 is the command byte, and the aux lype byte defines 
the packet as cither exiGnded or standard. Aux lype = ;$S0 indicales a standard packci, 
and 5C0 indicaLes an extended packet Command = SBX indieaies a standard packet, 
and sex indicales an extended packet. 

The contents byte as used for status and data packets, [t contains the error code for read 
and write operations. The SmartPort returns the contents byte as an errof code for the 
call. 

The contenL^ it'ielF Consists of bytes of 7 biLs (high bil set) of encoded data. Preceding 
the bytes themselves arc two length bytes. If the number nrcorteni byies is 
bVTECOUNT, !hen the fitsi byte is dcinned a.? BVITICOUNT DIV 7, and the second 
byte is defined as BYTECOUNT MOD 7. In other words, the lirsl byte specifics the 
number of groups of 7 bytes of content, and ihe second is the remainder. Note that the 
second byte will never have a value greater than 6- Both these byies have their most 
significant bit set. 

The general werhead bytes are packei begin and end marks, sync bytes (.6, to ensure 
correct synchronization of the IWMs), and a checksum The checksum is computed by 
exclysivc ORing ali the content data byte^s (8 bits) and the IDs, type bytes, status bytes, 
and length bytes. The checksum Is B bits sent as 16. 

Figure 7-13 demonstrates the sequence of signal transitiom [hat define the protocol 
for executing a read from a device Ibe signal tfart^ition points are described below. 

1. HtJSl asserts REQ when ACK is negated; command packet is coming from host 

2. Host enables IWM and sends packet to device. 

3- Device dcisserts ACK, signaling host that packet was received. 

4 . I lost rcspnnds by deasserting REQ. 

5. Device assert? ACK when it is rc-ady (o send responje packet to host 

6. liost aiserts REQ when it i^ ready to receive response packet from device. 

7. Device enables rWM and sends response packet to host. 

8. Device deasserts ACK at end of prackei 

9. Host deasserts REQ when packet Is received. 

]0. Device asserts ACK to Indicate it is ready to receive a command. 
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ACK 



Drke WM 



Hosf IWM 



[>rtvedGrta 



HDsf <data 




^ 



^ 




Figure 7-13 

SmprtPort bus commLinlcatlons; read protocol 

Figure 7-1^ denionstfatcs the sequence of signal tiafisitions that define the protocol 
hr executing a write to a device. The signal uaasiticiii points aie described hdow. 

Ir Host asserts REQ when ACK is negated and command packet is coming from hoM. 

2. Command packet is seni, 

3. Device asserts ACK^ signaling ii received the packet. 

4. Host ne^at&5 ACK, Tnishing the command handshake, 

5. When REQ is negated and device Ls ready to receive data, device negates ACK. 

6. When ACK is negated and host is ready to send, host asserts HEQ. 

7. Host sends write data. 

8. Device assens ACK, signaling it received the REQ. 

9. Host negates REQ, allowing device lo write data to its media. 



The SmartPort bus 



161 



10. Device negaieiS ACK and wriies data to its media. 

11. Hasi responds to negated ACK by asserijrig REQ, signaling it is ready For sutu^. 

1 2. Device responds to KEQ by sending statu.? lo hoSL 
13- Device a$$€rt5 ACK, signaling status has been sent. 
14_ Host acknowledges receipt of status by neg^Ung REQ. 

15- Device negates ACK when it is feady for the nejrt command 



REQ 



ACK 




^r^^ 




Drive IWM 



HOSI MttA 




Drive data 




Host ciata 




Figure 7-14 

SmartPort bus communtcotions: write protocol 

Figure 7-15 illustrates thai a command packet coniains ss Tew as zero and a^ many as 
767 data byte-S- Hach packet of 7 daca bytes is encoded in a specific manner, described 
below, to assure that cadi data byte (hat is part of the packet has its masi significant bit 
set Ta allow all possible bit combinations [o be transmitted in this manner, h is 
necessary to transmii S daia byffis of encoded information for every 7 bytes of data. If 
there is not an even multiple of 7 bytes in the total data block lo be sent, then the 
remaining D to 6 daia bytes are encoded and sent preceding ihe packets of 7 encoded 
byies, as 2 lo 7 data, bytes as described beiow. 
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Packet begin maik 



DaSTindtlon ID (SBQ-SFEJ 



Sourca ID (^SO-SFE) 



I Host ID alwavs - SaO, 
J— tifil dsvlee In chain = S6k, 
I second device In chain = £52 



Packet type (S30— Command Docket) 
(Sei -Status packer) 
(SS2-Dara pocket} 



Aux Tvps (SfiO) 



Data statui byre (7 OiTs) tSiBO-SFFj 



Lengtti at pacl^et contents 'odd* byles (SM-StWJ 



Lengtti of pacltet contents groups ol 7 data bvtas (S-flC^SEDO 




c? 1 c5 1 c3 1 cl 



Pachet contents 



Groups of 7 data bytos written as a; 
fTjOlt significant bits atl In tirst byte 



Checksum (B-bIt XOra or pacicet data 
ond oyres \-& aoove? lenr FMj 
every othsr bit = l 



sea 



Packet snd maiK 



Figure 7-15 

Sfnart-Port bus 'pocket format 



For each group of 7 data bytes in the b3ock lo be seni, i^ke the bits of which those byies 
arc cprnpcKsed and rearrange ihem as shown in Tigure 7-l6. This chanja;es the 7 bytes of 
input dati into 8 bytes of encoded data, in which each output data Ejyte ha? ii5 most 
s.ignificanL bit set. 



I Oddgroijpof 
(2-7 byt« s&nn 



Group Of 
'I data itiytes 

[a bytes senf) 



GrouD of 
7 data bytes 
(B bvtes bent* 



» * « 



Group Of 
7 data bytes 
fa bytes sent; 



Pocket Sizes range rrom to Itl dotg bytos. 



Figure 7-16 

SmartPort bus packet contents 

As Table 7-7 shows, the nr^t byte contains the moai significant bit of each of the 7 data 
bytes, the second b>'te contains the seven least significant bits of iht first 4.!ata byte, the 
third byte contains the sevtn least significant bits tjf tine third data byte, and so on for a 
total of S bytes of encoded data. This data is transmitted with the byte containing the 
most significant bits firat, followed by each of ttie other 7 encoded dafa bytes in turn. 
Ttius. you can see that if there are fewer than 7 data bytes in an odd sr^iup,, fewer than 8 
bytes of encoded data will be required to transmit this odd sroup. 



ToblD 7-7 








Doto byte encoding tobl© 




fop bll^t byte 


dl, 


d2-, 


d37 


Byte 1 


dlfi 


dl, 


dli 


Byta 2 


d26 


d25 


d24 


Byta 3 


d3s 


d35 


d34 


Byt« 4 


d4g 


d4g 


d^4 


Byte 5 


d5s 


d5s 


d5^ 


Byte 6 


ct^s 


d65 


d6^ 


Bytft 7 


d^6 


d7, 


d7, 



d4, 
dl^ 
d23 
d33 
d43 
d53 
dS^ 
d7. 



d5, 


dfi^ 


d7. 


dl^ 


dli 


dlfi 


d22 


d23 


dZo 


d32 


d3i 


d3a 


d42 


d4, 


d^n 


d52 


d5i 


d5n 


d6. 


d6. 


d6n 



d7. 



d7, 



d7n 



The number of bytes in the odd group is the remainder of the number of data bytes in 
the packet divided by 7. When encoding the odd bytes, assume that rlie test of the data 
byjes making up a group of 7 b>ies alf contain zeros. Also noie that if theie are no odd 
bytes (thai is, if the packet size divides by 7 evenly with no remainder), the odd-bytes 
group is siittply omiued, Similarly, i/ the number of byies in the packet is les* than 7, 
there will be no encoded packets of 7 bytes, but only an odd-bytes group will tx; sent. 
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Fo; example, if you are sending a 51^-byle p^ckei, ihq number of groups of 7 bytes is 
1% wkh a remainder pf 1- Therefore, the first data byte will be sent as an odd group, 
foUewed by 73 groups of 7 bytes each. The groups of 7 bytes will be encoded 3S 
indicated above and the odd bytes Cbyte nnjmber 1 of the packet, data bils 7..0} will be 

seni 35 sbowr; in Figure 7-17- 



lltttM ^^titi7..it ^fctti7(5 '*^blfi7 *bft70 '^bftll '^^blti7..0 



1 


di ,, 


3 


C 








□ 





1 


^1 
01 6 


dls 


c"-, 


dl^ 


dij 


all 


ti^o 



figure 7-17 

wF layout of o 7-byts data packet 



Top bira Byte 
Byte 1 



Rgurv 7-1 A 

IransmJrting a 1-byte data packet 

NoTC that the top bits for data bytes 2 through 7 in ihL? example are set to zero, and the 

data bytes ihai would have contained the least significant dala bits of bytes 2 through 7 
ife not trarLS mined. This is simply a special case ofan instance of a group of 7 bytes. 

Tat^ 7-S and 7-9 provide a visual summary of the conienLs of the standard and 
extended command packets. "WJtere ihere is an asierisk in ihe; table, the value of the 
corresponding b>'EE position is undefined and should be ignored by ihe device, 
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Table 7-8 

Standard command pactet contents 



ff 



Byte 


StDtUI 


ReadBiock 


Write BFDck 


Format 


Control 


(ntt 


Open 


Clos* 


Peod 


Write 


1 


SCO 


SO] 


$02 


S05 


$04 


S05 


S06 


$07 


5oe 


$09 


2 


Param 


Param 
count 


Parann 
^zounL 


Para en 

couni 


Param 
count 


Param 

COUnl 


Param 

count 


Parsm 
oiunt 


Param 
count 


Parsm 
Ha>un[ 


3 


Byie 5 
of 

pa [am 
itst 


a>te 3 

of 
par am 


Byte 3 

of 
param 

list 


# 


Byte 3 
of 

p»ram 
list 


« 


Byie 3 

or 

param 

J LSI 


Byte 3 
of 

param 
list 


Byie 5 
of 

param 


Byte 3 
of 

p^lram 
lisl 


A 


Byie 4 

of 

paraiD 

lisl 


Byic 4 

of 

param 
List 


Byte 4 
of 

param 
list 


« 


of 
param 

list 


■ 


Byie A 

of 
paratT) 


Byte A 
of 

pa rami 
list 


Byte 4 
of 

param 
list 


Byte ^ 
of 

param 
list 


5 


■■ 


Byte 5 
of 

iisi 


Byic 5 

of 
param 

ti^t 


K 




« 






Byte b 
of 

param 
lh[ 


Byte 'y 

of 

param 

Ei^t 


6 


• 


fiyle 6 

of 
parirn 

list 


Byte 6 
of 

param 
list 


\ 




» 


■ 


■ 


Byte 6 

of 
psram 


Byte 6 
of 

parani 
list 


7 


■ 


Byie 7 

parun 
list 


^^px 7 
of 

param 
list 


* 




* 


• 


i 


Bvte 7 
of 

param 
list 


Byte 7 
of 

param 
Hsi 


B 


• 


■ 


V 


V 


* 


« 


« 




Byte 8 
of 

param 
list 


Bjte a 
of 

pacaTTL 
lt5C 


9 


• 


A 


« 


« 


« 


■ 


< 




Byte 9 

of 
patam 

list 


Byte 9 
of 

param 
list 



* A byie with an indeterminate value^ the devifc should ignofc the byte. 
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Tabi* 7-9 

Extended cor 


nmond packet contents 
RwidBtock WrtrchBlock Formar 


Contiof 












3 


1 Bv1« Statuf 


IMt 


Op*n 


Close 


Read' 


Writ* 


^ 


H 1 $40 


541 


H2 £"13 


$44 


S^5 


5-16 


J47 


S4fi 


J-19 




^H 1 Para m 

^1 >::Ayrk^ 


count 


Piram Param 

count coual. 


Param 
count 


Param 

count 


Param 

count 


Param 
count 


Param 
caum 


Psram 
count 


1 


H 3 Byte 5 


Byte 5 
of 


Byte 5 

of 


Byte 5 

of 


■ 


ISyt*: 5 
of 


Byte 5 


Byie 5 

of 


Byie 5 
nf 


i 


^^1 par^rn 


param 

liSL 


param 
List 


list 




param 

ILst 


param 
list 


p^rum 
List 


param 

li£t 




^H 4 Byte 6 


Byte 6 
of 


Byte e 
of 


Byic 6 

oF 


* 


flyie 6 

of 


Byte 6 

of 


Byte 6 
of 


Bvic 6 
of 






param 

list 


pacaim 
list 


pafiits 
list 




param 
list 


pantm 

List 


parjim 
list 


parani 

list 




^T ^ 


B^te 7 

of 
param 


Byte 7 
of 

param 
lis! 


■ 


a 


V 


V 


Byte 7 
of 

pa tarn 
list 


B>ie 7 
of 

pariitl 
list 


1 


1 6 


Byte & 

of 

pafam 


Byte a 

of 
param 

Elst 


■ 


■ 


■ 


■ 


Byte B 

of 

param 

Ii51 


Byte e 
Of 

param 
Ibt 


i 


1 7 


Bjle 9 

of 

param 

lisi 


Byte 9 
of 

param 
lis: 


■ 


• 


■ 


A 


Byte 9 

of 

param 

li^ 


Bvte 9 
of 

fMiram 
list 


i 


1 e 


« 


* • 


■ 


« 


« 




Byte ID 
of 

par:im 
list 


Byte I a 

of 

param 

list 


3 


1 9 


? 


■ * 


* 


« 


* 




Byte n 

of 


Byte 11 I'^l 


1 














Jlsl 


param 

list 


1 


H, ■ A byte with an indeierrn tnaic value; Lhc dcvtcc should ignore 


the byte_ 
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lliis chapter describes how Lhe Apple IIGS handles intermpiis from ihe available 

imernjpi sourc&s. You can find adtiilional information about interrupls in 

Appendix D, "'Victors.'" Thi_s chapter destribcs inCeinjpLS in gtneral an«J the 

Apple lies buili-in intemipi-handlcr firmware in particular and how to manage 
environment variables during inlecrupl handling. It also summarizes all interrupt 
sources, discussing how ofien each source intemjpis the sysiem and lhe relative 
priority assij^ncd by ±c system to each source^ and provides some detaiU about Break 
instructions, the AppleMouse'", and serial-port inlerrupt handling. 

As a user's program runs, it may get interrupted by various sources to process 
important exiernal inputs. The sysiem assigns priorities to each of these interrupt 
sources and handles ihem in a defined sequence. XC'lien Lhe user's program is 
interrupted, the stale of the system at the lime of the interrupt is saved. On completion 
of inlerrupt processing, the program can continue as (hough nothing had happened. 

There are many reasons for the sysiem to interrupt the tiecutinn nf a program Fpr 
cxampk', if the ujier mnvq.s [he mouse, lhe system should read the mouse location to 
keep the pointer location current If the system handles the Ln^rrupt promptl/, the 
mouse ptjinier''s movement on the screen will be smooth insiead of jerky and uneven_ 
Or your program may be perforniing another operaiitin while characiers are being 
receJvc-d in a serial input buJTer, and you do not want to lose any characters from the 
input stream. These conditions, and many others, can cause your program to be 
intcnxipTGd Lo ha,ndle an error or some other special condition diat requires 
immediate attention. 

The Apple ilCS interrupt-handlcr firmware supports inlerrupls in any memory 
conlfiguraiion. To do this, the system saves the machine's state at the Umc oFthe 
interrupt, placing iht Apple liGS in a standard niemorv' configuration before calling 
your progrgjn's interrupt handler, and then resLoits the original state when your 
program's interrupt handler is finjshed. 

If you write your own interrupt-processing routines, you can attach them to the system 

by modifying the interrupt vector locations specified in Appendix D, 'Vectors." 
However^ you must obey aU of the conventions specified in this chapter regarding 
intemjpi processing and make sure to restore the environment to the state in which 
you found it on entry to your interrupt-procc-ssing routine- Ttiis will allow the system to 
restore the environmeni to lis original state. 
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What is an interrupt? 

An interrupt is most ofien caused by an externaJ signai ihai tells the computer to stop 
what it is cuffcnlly doing and devote its attention to a mo:e important task. Besides 
[his external hardware-related signal, software iniermpts are pnssible as 'well. 

Hardware Interrupt priorilies are established through a daisy-chsin arrangement usfng 

two pins, INT IN and INT ourr, on each peripheral- card &I01. Hach peripheral card 
breaks the chain when it issues an intermpl rcqucsL On peripheral cards thai don't use 
iinffinupLs, the designer of the peripheral card should connect these pins: to one 
mother, thereby passing the interrupt signal direcdy through the card sloi. 

lifi^R ttig latemipt R^nmi (ittQ) ling an l)i§ Apple Us§ Bicf6pfSc§i§or li seUvited 

or when a software interrupt occurs, the microprocessor tran'^fcrs control to the 
Liiterrupt-prcKessing routines by fumping through vectors stored in UOM. 'I'he built-in 
interrupt handler processes the interrupt if the application has not provided its own 
imermpi handler. 



What Is on Interrupt? 
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The built-in Interrupt hondrer 

Tlic Apple IIGS built-in iniemipi hardier pcrfDrms a sequence of steps tu handle 
system intcrmpis- Figure S-l shtiw^ ij-ig sLmcture of Lho built-in interrupt handler. 
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If I/O shadowing is on, ihen the system ROM in bai\k JFF is shadowed (and reathble) 
in bank $00. The system jumps LndirecUy through the iniermpt vector Located either al 
EIRQ CSE^FH, SFFFF) if it was running in emulation mode when the iniarnupt cKicuired 
or at NIRQ CSFFE4, $KFB53 if it was running m naLjve mode. 



liTiporlant 

If I/O shadowtrug Is off. RAM will be oddressed tn the merrrarv spoc© at bank SOO in 
ihe orec of SFFEO-SFFFF. The locotioni at which the Intenupl vectors are stored. 
When an Interrupt occurs, the 6SC816 uses the Interrupt vector locoted (n ttie 
RAM vector table If I/O shadowing Is off and uses the vector located In the ROM 
vector tabte if I/O shadowing is on. if vou have not correctly set up the RAM 
vectors and you turn off VO shadowing, the system wHI foil, 



Both ElRQ and NTRQ jump to ROM located within the soft-switch area at 
JC071-$C07F, Ttm special ROM code sets siaais fiags that identify the type of intemipt 
Lhai has just occurred. 

At this point, the system tests to see wtieUier the interrupt was a jesuIi of a software 
Bieak instmcUon. If it was, the system vectors lo the break handler Cnomially the 

system Monitor) through the liser interrupc-handler vector in bank SET. An 
application will patch this veaor only if it wants lu be responsible for handling or to be 
icirormcd about all interrupts that occur. IF the application simply wants information, 
it must save the vector vaiue tha; the application Tinds in th!5 location and then jump 
[hraugh this vector as the user-interrupt code is completed. Saving and using the 
vector allows the system to proceed a5 though the application had never gotten in the 
way in the Tirst place. If the application wants lo handle ail irtterrupi processing on its 
own, it must be responsible for restoring any environmem variabSes that it changes 
and must execute an RTl instruction directly from Its own code^ returning to the 
application that was Intemjpted. 

If the mtermpt source was not a Break insLruciIon, the inlerrupt handler saves the 
absolute minimum amount of information about ihe machine state. The interrupt 
source might have been AppIeTalk (tested first) or the serial pom (tested neiO. If you 
are mnning at high baud rates and if interrupt processing takes too long, you might 
begin (0 miss characters. To Sive the minimum machine state, save only the 
environment variables that have to be used in the routine thai saves an incoming serial 
character in a buiTer and points the buffer pointer to its next location. To see whether 
the interrupt was from a serial port, the 5CC is tested, tf it is a serial interrupt, the 
Firmware performs a JSL instruciion through a patch address in bank SEl to the poit 
handler <see Appendix D, ''Vectors," for more informalion). 
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ir Lhe pen handler returns wiih ihe carry bii sei, Ihe system does not have an iniema] 
serial-port handler insuUed. The [nienupc handler now proceeds to save the rest of 
ihu machine .siale and esiabli.'ih a specific inteffupt fnemory configuraljon as 
described in ihe section 'Saving the Current tr'nviroriment" later in this chapicn (Yoli 
must poll each of ihe possible imenupi sources lo determine which requires service.) 

At ihis point, the iniemjpt syfitem liegins a polling loop, lesUng each of the possible 
intcrmpl sources in turn. If no inlernal interrupt handler is installed, [hen (and nnly 
ihenj [he Firmware [umps ihrtmgh [he user intemjipt vector routine to handle the 
interrupt. The address of the user inLerrupt routine is found in bank SOO, addresse? 
S3PK Cow b>lc3 and S3FF (high byie), 

The S3FE interrupt hindler Cuiicr interrupt vector routine] must do the following: 

D verify thai the interrupt came Trom the expected soun:e 

D handle the Iniermpi appropriately 

n clear the appropriate inleirupl soft switch 

D restore everyihing to [he state ii was in when ihe Inierrupt Retjuest routine was 
entered, if your routine has made any changes to the state of the machine 

n return to the built-in inlernipl handler by executing an RTI instruction 

After the user interrupt vector routine completes its action, the built-in internipt 
handler restores the memory conHguraUon and ihen executes another RTI to relum to 
where it was when die inierrupt. occurred 

Here are some factors to remember when you are desling with programs that run in an 
internipl environment: 

a There is no guaranteed maximum response tinve for internipts because the system 
may be performing a disk operation diat ]a$L$ for several seconds ^tvhen ihe inierrupl 
occu rs. 

□ Interrupi overhead wili be greater if your interrupt handler is installed through an 
operating system's interrupt dispatcher. The length of delay depends on the 
operating system and on wltcLlier the operating sysicin dispaLches the interrupt to 
other routines bcFctrc calling yours. 
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Summary of system interrupts 


1 


Table 8-1 lists the 


source and E>'pe o 


f each iniernjpi and describes each one. 






Tables- 1 

Surrimarv of system Interrupts 






InrHirupt 40U1C* 


Typ* 


DtscrlpHon 


Power up 


RESET 


Gcni^rated by powering Lp Apple IIGS. 




fesei key 
J 


RESET 


Generated by the ADB micioconlroller when 
Control-Reset is pressed. 




^m 


1 External card 


RESET 


Avaitabte. 




^M 


1 External card 


NMl 


Used only for debugging. 




Bf 


1 

Abort signal 


ABORT 


Activated by memory card slot. 




H 


COP instruclian 

1 


COP/native 


In nali\'e mode, the user executed a COP 
instrijCUOn. 




■ 


I COP 


COP/eitiulation 


In emulation nwxle, the user executed a COP 




■1 


Break insUuCliOn 


BRK/native 


In nativTi mode, the user executed a Bnjak 

CBRK) instruction. 




1 


Break 


BHK/emulalJon 


In emulation mode, the user executed a Break 
CBRK) instniciion. 




^^^B 


Apple Talk 


mQ 


Inierrupis upon address recognllion or an 
error, 






Serial input #1 
(see channel A) 


IKQ 


Interrupts when transmitter is empty, 
transmission is recetved, or an error 

occurs. 




L 


Serial input *2 
(sec channel B) 


IRQ 


Same ss serial input #1. 




^K 


Scan line 


IRQ 


Interxvpls al end of requested scan lines. 










(conTinLiad) 
Surnmary of system Interrupts 
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Summary o^ syslem Int&rrupts Ccontlnued) 



Intoliupr Hurc* Type 



Dfttcrlpllon 



Ensoniq chip 



VBL signal 



Mouse 



Keyboard 
Response 



SRQ 



Qock chip 

Externa] card 

EX'l'INT 



IKQ 



IRQ 



IRQ 



Quarter-second IRQ 
timer 



IBQ 



IRQ 



Desk Manager IRQ 

Flush command IRQ 
Micto abort IRQ 



IRQ 

IRQ 
fflQ 



Interrupts when an oscillator completes a 
wavefomii [able C32 possrbte inierrupLs from 

here). 

Intiarmptj when vertical blanking (VBL} is 
requested. 

Iniefmpts as requested at mouse button press 
or movement or at 3: VBL signal. 

Interrupts system frvety 0_S6667 second for 
AppieTalk use. 

Iniernipis upon keypress. 

Generated when data is ready for the system 
from the Apple DeskTop Bus (ADB) 
microcontrollef; initiated as a result of a 
system generaied command- 
Generated when an ADB device requires 
servicing. 

Generated by the ADB microcontroller when 

Control'^-Esc is pressed- 

(i^Control Delete was piessed 

Generated if the ADB mEcrocorLtroller detects 
a fatal error within (iself, 

A 1 -second timer Eniermpt is generated by 
the l-hcrti signal from ihe dock chip Ehrough 
the VGC chip. 

The card wants the attention oFthe 65C816. 

Availab!e from the VGC, but noi to huuk an 
exiernal inierrupLing device; hardware is not 
avail able - 



176 



Chapter 8: Interrupt Hand ter Firmware 



fnlerrupt vectors 






Table S-1 descrilxrd Lhc 


.sources of interrupt and named [he tnlerrupl vector thai 


contains the address of the routine Lha 


L processes each intern.ipL Table 8-2 deHiies the 


iocaUons at which each of the named 


interrupt vecEois resides. 


Tablft 8-2 






Interrupt vectors 






Adclr«» 


Nom* 


Da&crlptlon 


^btl't-Si-H-t 


IRQVECT 


Ernuladon-mode IRQ/BRK vector 


$FFFC-SFFFD 


fitSET 


EmuSation- or native-mode RESET vector 


SFFFA-SFFFB 


NMT 


ErnuUtion-modc MMI vector 


tl-FJ-Ml'i-l-? 


EABORT 


Emulation-mode ABOBT vector 


iFFF4-SFFF5 


ECOP 


EmulaiiDn-modc COP vector 


SFFEE-SFFEF 


NIKQ 


Nadve-mode tRQ vector 


SFFEA-SFFHB 


NNMI 


Naijve-mode N'MI vector 


SFFE6-5FFE9' 


N ABORT 


Native-mode ABORT vector 


$H'h:6-SFFE7 


N BREAK 


Nadve-mode BKK vecEor 


iFFE4-SFFE5 


NCOP 


NaUve-mode COP vector 



If [/O shadowing L5 on, ihe vectors contained in ftOM are always used by the 65C&16, 
regardless of the language-card sellings. Thi^ allows you to run nanive-mode code with 
interrupts enabled in old applications. 

If the application program or operating system disables I/O shadowing in bank SOO or 
SOI. then either the appliciiJon program Or \}i<i Operating System muat copy the ROM 
vectors from SFFEF to IFTFF and the code rrom $0)7] to SC07F into RAM at the same 
locations befon; enabling inicmipti^. Lf the code is not copied from ROM to RAM, the 

Monitor's internjpl code cannot be used, 



Interrupt priorities 

The 65CS16 processes each type of interrupt on a priority basis. For instance, if severaJ 
oFlhe many IRQ interrupts should occur at the same time, the 65C816 wt!l process all 
Applel'aEk IRQs before any keyboard internipts. Priorities for each type of interrupt 
are indicated by their relative position in the followtnjj paragraphs. In other words, 
the highest-priority internjpL^ ^pp^ar" closejit to the fxfginning of these descriptions. 
Lower-priority interrupts appear later in the descriptions. 
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RESET 

RESET forces emulation mode. The Lntermpt is processed by the firmware and ihen 
vectors to the user link. A cold start attempts to boot a disk. A cold sEiil can be 
performed in two ways: 

D by turning ihe power olT and on 

□ by pressing O-Control-Heset 

RESET cold-siart functions sue as follows: 
D sets up video 

□ sets video as output device 

□ sei5 keyboaird a5 inpyi device 

n reads clock chip and places system configuratian in firmware RAM 

D sets up sv'siem to match configjration in firmware RAM 

D sets up the power-up byte so itie nexl RBSCT performs a wann start 

D scans slots for Disk II devices and sets motor-on detect bit Cmoto;-on detect causes 
ihe FPI chip to slow the system down 10 1 MHj: when ihe moior-on soft switch is 
enabled, and it restores the system speed when the motor is turned ofR 

□ goes tOj or scans, for boot device Qf boot device is found, jumps to it- if no boot 
device i^ detected, switches in Applesoft BASIC and jumps to it> 

A warm start vectors to user links, Ifuser did not alter links, then a BASIC cold start is 
execuled. A warm start can be performed in two ways: 

a by pressing Control- Reset 

D by using peripheral cards Cpulling RESET line low) 

The system executes the following reset warm-start functions: 

n sets up victeo 

□ sets video as output device 

D sets keyboard as input device 

o reads image of system conflguraiion in firmware RAM 

D sets up sv'stem to match co.nflguraUon 

n generates tone (beep replaced wirti tone) 

D funi.ps CO user reset vector 

NMI 

NMI vectors to user link. No NMI inieriupts are used by the Monitor. Peripheral cards 
pull NM] line low. 
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ABORT 

ABORT veaoTS to the user link. If no user link exisEs, ir vectors lo the break handler ihai 
(lispEays. the address and opccde of Lhe code being executed al ihe lime (he sbon pin 
On cho 65CSI6 was pLiUc;d law C^ec BRK). The: ABORT iiiLcrmpt CAt\ be activated only 
by hardware installed In the memory-expansion sloi. 

COP 

COP vectors lo the COP (coprocessor opcode) manager vector in RAM, which poiriLs 
\D lhe firmware. If lhe COi' manager is nol inslailed, lhe Hrmware displays Lhe COP 

fft&sagc via a software COP itistnj£Ut]n 

In cmulaEion mode. COP prinis lhe following: 

trii^addr : OQ cc COP cc 

A^aaaa Jf^jijofx ¥-yyyy S-asas C-dddd P-pp 

Brbb K-StJt M-mm Q-qq L-l m-cn x-'X cl 

It native modCj COP prinis the following: 

blj/'addr : OD cc COP cc 

fc-asfld X-xxxx Y-yyyy S-ssss D-dddd P-^pp 

B("bb K=)tlt M=tnjn Q=qq L=l m=iii x=k e=Q 

♦ .Vote; The preceding fofmats arc for a -^O-colgjinn scrccn_ On an BO-column screen, 
ihq second two lines t>ecome one line. 'I'lie ec appearing in both modes is the 
operand of the COP inslnjcuon and indicales lo the user where the COP occurred 
(500 through $FF are valid COP operands). 



BRK 

In emulation mode, lhe interrupt vertors to the in[c""rup[ QRQ) handler and tfien lo 
the Jjreak h3.ndler. In native mode, the inieirupt vectors directly to a break handler, 
This occurs via a software BRK instruction only, llie brealrE handler saves as much data 
as the interrupt handler. Tfils allows you to invoke rht; Myniior Resume tommand CK) 
to coniinue program execution. 

In emulaUon mode^ the Brealt instruction prints the following: 

J5b/add.r; 02 be- BRK CC 

n=zasA x-j^xxx V-yyyy 5-sss6 D^dddd P^pp 

B-bt K-kX K^mm Q^ftq L=l m=ni x^k s=I 

In native modet the Break instruction prints the foUowing: 

bb^addr: 00 J>c BRK cc 

A-aaaa X^nnna Y^yyyy s^saas D=dddd P-pp 

B'bb K=kk K=nm C=qq L=l m=n k^x e-0 

* Nole: The preceding formaEs are for a 40-column screen. On an SO-cnlumn screen, 
the second two lines become one line.. The cc apjxiaring in botli modes is Lhe 
operand of the URK instmction and indicates to the user where the BRK occurred 
CSOO through SFT are valid BRK operands^ 

SLimnrrary of sv^tem Interrupts 
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IRQ 

IRQ incerrupts are as folJows; 

ApploTalk: This inEerrupt has the highest priority t^ecause its code is vcjy Lime 
iniensive; data can l^e lost if the SCC is nc>i read wiihin 104.167 microseconds 

Cbaud = 230,400) after an AppleTalk SCC inlerrupt occurs, 

Serial ports: In intcrrypL mode. data, will be lost if the SCC ts not mad wiihin I 
milliseconds Cbaud = 19,200) after the interrupt occurs. 

Scan lfn«: 'ITie scan-Iine inlerrupt can occur every 63.694 microseconds. VSThen ihe 
video touniers count down lo zero, the inlerrupt occurg. The video counteis icach 
zero when the scanning beam reaches the right side of the scan line. 

EnsQnIqchIp: The Ensoniq chip internupi5 when the waveform buffer is compleied. 
Bticaii^e (he chip coniains 32. oscilEators, ihere are 32 possible inLcrmpcs from the 
chip. 

VBL The VfiL inieriupts every 16.6667 milliseconds. The iniemipt occurs when the 
scanning beam is retracing from the bottom-right corner to the upper-left corner of 
the screen. (A'O/e, Using the hearibeai intermpt handler is the approved jneihod of 
executing VBL inietrupt tasks.) 

Mou»: The mouse internjpts only if the interrupt option i$ specified, The interrupt 

option* are mouse movement^ mouse button ptess. and VBL .signal, 

Quarter -second timer: This timer interrupts every 0.26667 second. The timer is used 
by AppleTalk lo trigger event processing. 

KsyboQid: The keyboard interrupts if a key L*; pressed. 

S*sponso: if a command is sent to the ADB microcontroller, the intemjpt occurs 
wimn Ihe "done" flag is set. The microconlroller interrupts the system when the 
response data is ready for the system to read. If this iiiEcrrupi Qccurs, control is paissed 
to the response manager. 

5RQ: If an ADB device requires servicing, an SRQ {service request) is issued. This 
event can internjp! ihe system, mien this internjpL occurs, conuol is passed to the 
SRQ manager. 

Desk Manager: The ADB mtcrocontroEler causes this fnierrupt if Contrql-cl-Esc is 
pressed. Control is then passed lo the Desk Manage;- 

Rush:Ifc5<:onirol-Dack£pace (Ddele) is pressed, the ADB microcontroller clears its 
internal type-ahead buiTcr, issues a Hush command to external keyboards, and causes 
an interrupt. If this interrupt occurs, control is passed to the Scrap Manager. 

Micro abort: If the ADB microcontroller detects a fatal error and the fatat-error 
iniernipt occurs, ihe system is jnternjpted. If this Enterrupl occurs, control is passed to 
tho ADB Tool Set. 

Clock chip: The dock chip intemjpis once each second. 

Extftfnol cards: External card* cause interrupts 35 defined b>' the caid manufacturer 
lao Choptera^ Interrupt- Handier Firmware 



Environment handling for interrupt processing 

For each iticermpi discussed in the previous section, the processor can l>e in either 
emulation or native mode. Each mode has its awn interrupt vector; therefore, there 
are iwQ difTerent entry points to the inLerrupt h.andler. To process tnierrupis correctly, 
[he sysEent irnemipi handler musl save the current environmeni, set the interrupt 
envjronmenl, and process the interrupt through ihe appropriate interrupt handler 
(You Can find mcjre infonnation about saving and restoring the environmeni in 
■Chapter 2, "Notes for Programmers." Thai chapter contains sample assembly- 
language code that saves a part of yojr environmeni and sets the syHiem into the 
correct mode for interrupi processing. 5 



Saving the current environment 

Oncntiy to each iniernjpij [he system interrupt handler saves the current 
environment and setj; the profiram bank, data bank, and direct-page register contents 
[0 zero. 

The slate of the machine upon entry into each interrupt handler is indicated by the 

contents of the following registers: 

D program bank 
D data ba.tik 

□ direct register 

□ processor status 

□ A register 
u X register 

i □ Y register 

The RAM or ROM state, including emulation or native mode, is indicated by ihe 
Following- 

u language card state Cbank 1 or 2, ROM or RAW) 

n main or alternate memory (and main and aliemale zero page) 



. _.JR£ switch 
JS^iORE switch 



D AG- or ftO-column video 
D main stack or ?ero page in use 
n speed register 
D Shadow register 
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Going to !he interrupt environment 

If the interrupv can be processed by the Hrmware or a too! set, \he processor vectors to 
the appropriate handler in native modc^ B-bit m/x, in high speed, [f the inirrrupt 
cannoi; be processed by the Tirinware, the processor performs the following stepsr 

1 . Switches 10 emulation mode 

2 . Switches speed to ] MHz 

3 . Switches in text page 1 to make main screen holes xvaitable 

4. Switches In miin memory For reading and writing 

5. Maps 5DO00-SFFFF ROM into bank SOO 
6 Switches in main siadt and zero pa^ 

7, Saves ihe auxiliary stack pointer and resioics the main slack pointer 

After ^e environment is saved and the new environment is set, the interrupt handler 

chccicN for the source of the interrupt. If the interrmpt is a firmware intemipi only (a 
BRK or COP insuuciion), the firmware jumps {using a JSQ to the apprnpriate firmware 
routine. If il is an intemipt thai is passed direcUy lo the user, then the firmware passes 
the intermpt to the user via the appropriate links An interrupt can be both prccesscd 
by the firm ware and passed to the user. If both occur, [he preceding rules Itsted still 
hold, except iJiat the particular firmware interrupt handler will return id the main 
interrupt handler with carry sel (C - 1) instead of clear CC - 0), which indicates dial die 
firmware processed the interrupt and the user does not need to know about it 
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gestor^g Iha original environment 

After the interrupt has been processed, the system inlerrypi handlsT restores die 

environment and registers to their picintermpi stale and performs an RTI, returning to 
the executing program. 

♦ Note: The peripheral card (or equivalent internal aid) in use is respoitsibic for 

saving its slot number In the form SCji (n = slot number) at MSLOT CS0007F8), 
MSIjOT ls used in ihe iniemipt liandler to restore the currently executing slot 
number's SC800 space after a.n interrupt has been processed. 

Emulation-mode interrupts are supported in bank Soo only, Kative-mode 
interrupts are supported everywhere in memory, therefore, code running 
anywhere except in bank |00 mujit be native-mode code. 
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Handling Break instructions 

In emulaiion mode, the Apple liGS delects a software Break CBKK) instmcLion as an 
IRQ and JTumps ihrough ihe emulalion-mode IRQ vector, [n that code, ihe firmware 
determines that a. Break instruction was issued and so jumps throu;^ the emulaEion- 
raode BRK vector. In native mtxie, iho 65C-816 can tell the difference bcLween BRK. 
and IRQ, so it jumps direaty ihfough ihe native-mode BRK vecior. 



Apple IIGS mouse interrupts 

Itie Apple DeskTop Bus (ADB) mtcroconirollei- periodically polls ihe ADB mouse to 
check for activiiy. If ihe mouse ha^ moved or the mouse button has been pushed, the 
mouse firmware will respond to ihe microcontroller by reluming 2 byies of data. The 
mi crocon [roller returns this data [o ihe syslem by wriling both mouse data byita ig the 
GLU chip Cmouse byie Y followed by byie X — this erubles ihe inlerrupO, Data bytes 
are read only if ihe Event Manager Cif active) or the application program issues the 
mouse firmware call or the tool call ReadMouse. The CUJ chip is. ihe general logic unit 
[hat provides logic elements enabling [he 65C316 to communicate with [he ADB 
microccmtroller. 

The Apple llGS mouse firmware causes Lntcrrupls for ihe 65C816 microprocessor only 
if [he interrupt mode has been selected via firmware. The Apple ITgs mouse inierrupis 
in synchronization with the Apple IlGS vertical blanking signal CVBL). The mouse can 
inDsrrupt ihe 6%:si6 a maximum or6Q times per second. This culs down on the burden 
the mouse puts on the 65GS16. 

Ai power-Up or reset, the GLU chip turns the mouse inLerrupi off and enters the mouse 
into a nonintemipt stale. 



Serial- port interrupt notification 

when a channel has buffering enabled, ihe firmware services all interrupts that occur 
on that channel. If an application wi^he^ to service Interrupts for a given channel 
itself, the apptication should disable buffering using [he BD command in the Output 
flow, if the buflering mode is off, the serial-port firmware will not process any 
interrupts. The system intemipi handler will transfer control to the user's intemipi 
vecior as SQ3FE in bank 500 (this is the ProDOS user iniernjpl vector). The user's 
inierrjpt service handler is then completely responsible for all serial-port interrupt 
service. You can find Fjrthcf details about ihe serial-pon firmware and its commands 
in Chapter 5, "Scrial-Pori Firmware." 
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If the appLcatiofi does noi want to disabSe bufTering, but does wish to be noti/le<i \h^i a 
certain type of serial-port inLernjpi has occurired, the application can instruct the 

firmware to pass control to an appltcation-Jnslalled routine after ihe system has 
Serviced Uie iniernipt. "Hie application tells the firmware when it wishes to be notified 
and establishes the address of the appticalion's completion rouUne by u^ing ihe 
Seirntlnfo ruulin-e. This call guafanlees thai the completion routine will get control 
when a spcciilc type of interrupt occurs, but only after the serial-port firmware has 
processed and cleared the inEerrupt. The application [hen uses the GellnUnfo routine 
to deiermine which inicrrupt condition occurred. 

A terminaJI emulator offcis a typical example of when inlemipt notiElcalion might be 
desirable. The emulator usuaHy should perform input and output character buffering, 
handshaking, and Other sud-i operations. The terminal emulator can be designed to 
allow thti fiimwaie to handle all characcer- buffering details. The designer of the 
emula[or can have the firmware signal this emulator program when [he firmwart: 
receives a break character, To enable ihi5 special- condition notification, the emulator 
application sets the break interrupt enable function by using the Setlntlnfo rouline. 
When the firmware receives a break character, the firmware SCC iniemjpt handler 
then records: and dears the interrupt and finally pa.^scs control to the emulator's 
completion routine. This routine calls Gellntlnfo, and if the break bit is sel^ the 
completion fouiine ^(nows that a break character has been received. 

Note thai all intern; pt sources Cexcepi receive and transmit) caii-^e an interrupt on a 
tmnsilion in a given signal. This means that the user's interrupt handler will gel 
conirol pa.'ised to it on both positive and negative Uansilions in the signals of interest. 
For example, a break-character sequence causes two iniermpts; one at [he beginning, 
of the sequence and one at the end, '!"he user's interrupt handler should take this into 
account. A routine can always determine the current ^ate of the bits of interest by 
using die GetPonSiat rotitine. 

The inierrypt completion routine executes as part of the firmware interrupt handler 
and must run in that environment. In addition, the following environment variables 
mj5t be preserved at their entry to your routine: 

DBR - $00. e-Q, m-1. i-l 

Registers A, X, and Y n«d not be preserved 
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This chapier describes the Apple DeskTop Bus (ADB) micmcontrDller. This hardware 
device collects information from the ADB periphtral devices. In associaiion with the 
ADB Tool Sel, Ihe dau that is coUecced is available to the user. Typical data includes 
key-dDwii and key-up sequenceSf mouse moves, and button dJcks. The firmware thai 
performs these operalJons is not documented here. See the ADB Tool Sel 
documenlalion for information about the ADB firmware. This chapter is for reference 
only, providing a developer's view of the complete ADB system. 

The ADB device is an I/O port with its own microcontroller. The microeontrolter 
accepts commands from the 6$C8lS, manages the irnemal keyboard, and acis as a 
host processor for ADB peripheral devices Such as ihe mouse, the detachable 
keyboa-rd, and other devices chat follow the ADB protocol 

The ADB system has four components and three distinct software interfaces. 
Figure 9-1 shows the ADB s/stem from a hardware pers-peclive- 
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microprocessor 




ADB 



Mouse 



KByboard 



Figure 9-1 

AppEG DeskTop Bus components 

"Die four hardware components are ihe 65C816, the GLTJ (general logic unit) chip, the 
ADB microcDntrDlllcr, and the eomponenits allaehed to the Apple DeskTop Bus 
device. The application accesses the ADB components through the ADB Tool Set. 
The ADB Tool Set talks to the hardware by sending commands through the GLU chip 
to ihe microconLroller. Some of these commands require data trarisfer over the ADB, 
and others terminate in the mJcfocontroller. 

The GLU chip is actuary a sel of hardware registers (somciimes called maiibox 
registers) that the 65CB16 uses to Lransmit commands and data to the microcontroller 
from the 65CS16 and that the microcont/oUer uses lo pass data to the 65C616- Bgih the 
65CSi6 and the microcontroller arc independent processors, each running at its own 
pace. They exchange data through the GLU chip. 

The mlcroconiroller translates the commands ii rec£ive5 into data streams ihac it 
sends along the Apple DeskTop Bus device iisclf. All peripheral devices attached to 
the bus iisten lo the data stream being transmitted. If the command ts intended for a 
specific peripheral device, it responds and possibly transmits daia and status 
Information back to ihti micTocontrollcr. The microcontroller, in turn, translates the 
data and sends the translated data to the 65CS1S. 
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There is actuallir' one more sorrware inierface: the program running independenily in 
ihe micirocontrolJef itself, but that is inunatenal here. It is suflidenl lo nole ihai ihis is 
an imeiligeni peripheral device that manages commiin(ca,tion. 

Tlic Apple IIGS Hardware Reference provides details about the hardware interrace 
between the ADB microcontroller and its aiiached ptsripl-ieral devices and how ihe 
miLCrotnnuoHer manages the inlernali and external Jteyboard and the mouse, the reset 
sequence and die c5 key, key bulTering Ctype-ahead)^ and 50 on. 

The Apple TIGS Toolbox Reference provides details about the high-level commands 
Jiat allow access lo the items attached to the ADB. 

Although most applications do not require the information in this chapter, there are a 
few excepiiong; 

D applications that allow the user tcs temporarily change Control Panel options 

u alternative input devices such as a graphics tablet (however, an application may nol 
need lo wrjrry abtiui: this because 3 device driver can be transparently hooked into 
[be Event Manager) 

□ raultiplayer or multidcvice applications 

]f an application needs to temporarily change some Control Panel options, use the 

ADB Tool Set. Note, however, that changing certain option^, can cause the system to 
fall 

An application should not call the ADB Tool Set to change Control Panel options 
permanently. If a permanent change in certain system characteristics, such as the 
autD-repeat rate or buffer-mode options, Is necessary, the application .should make 
the dianges by changing the Battery RAM (using the Miscellaneous Tool SeO. Then 
the applic-ation should call the rotitine TOERAMSETtJP to update the system with the 
new Battery RAM values. 

If you are writing a user program that uses the mouse and tlit keyboard, you will 
probably not need the information in die rest of fhis chapter. For thai level of 
informaition, sci; ilie ^/"Jp^e //C,f Toofbox Reference. If you arc a hardware developer 
developing a new peripheral device for the Apple DeskTop Bus, you wil! need the 
infonnation given here as well as the information about the bus protocol it^-lf and 
interface specificatJOns for ADB devices. This latter information is in the Apple TIGS 
Hardware Reference. 

TTic discussion in this chapter focuses on [he ADB microcontroller and its 
commands. Tbc icj>[ of this chapter is for reference only; it shows ihe application 
dc-iigner the kinds of command? the ADB Tool Set issues to the microcontroller. Vou 
should not attempt to send any of these command streams to the micnDconiroller 

yourself. 

Important 

Microcontroller communicotlon Is exclusfve^y Itie Job of the Applg lies Tool Set. 
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ADB microcontroller commands 

The microcontroller uses two types, of commands: default and mode comnnfids and 
ADQ commands, The default and mode commands arc u-scd hy the Contioi Panel lo 
change 5>'5tem sellings. The ADB conirnands arc used to communicale with ADB 
devices otlicr Lhan the detachable keyboard and [he moij.se Cuhese are handled 
automat icallv). 



Cciuhon 

An application progfom must' Issue mterocontroller commarids only through the 
ADB Tool Set. If you attempt to use tties& commands directly, bypassing the tool 
set. you could eause □ syat&m fal[ura, <For more Information about ttie toot set. 
see thie Appls lies Toolbctx Ref&renca.') 

This section provides a detailed description of each ADB micrtjconiroilcr connmand. 
The command values are given in liiniry format where the mosi significant bit is the 
leftmost bit. A percent sign (%) preceding a string of zei"oe-s and ones indicaies a 
binary value, 1"he notation sy subsljluted for a binary digit pair in a command byte 
stands for 2 bits Lhai select one of fcjur possible registers. The notation abed syhstJtuEed 
for four binary digits in a command byte, stands for 4 bits that select one of 16 possible 
device addresses. 'l"he ADB can support up to l6 differenL device addresses, each of 
which may have four hardware registers 



Abort. $01 

This CDrrrniand syndironiats the mieroconiirQlter with the 65CSI6 mlcropracessof 
when a command error occurs. Abort is a I -byte command with a value of ^'cOOOCiOOOI. 



Reset Keyboard Microcontroller, $02 

This command returns the keyboard microcontroller to its powcr-up state. It is a 1- 
byte command with a value of %00O0OOlO. 



Flusti Keyboard Burfer, $03 

This command clears the keyboard buffer. Any keystrokes that were pending are 
forgotten. It is a 1-byte command with a i^lue of %0000001 1. 
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Set ModeSp $04 

This command sets mndes- It is a 2-bjie command; the first byte value is ^.-cOOOOOlOO. 
For irach biE sct in, the byte ihal follows ihe Set Modes command, ihe correij ponding 
mode bit is set. 



Oeat Modes, $05 

This command clears modes. It Ls a 2-byte command; the firui f.jyctr value is 
%(K)000101. For each bit sct in the byte thai follows ubc Clear Modes command, ibe 
corresponding mode bit is deaied. 

Table 9-1 lists command bit funclions. 

Table 9-1 
Bit functions. 



Bit 



Function 



7 Resets rrom the ADB detachable keyboard aSone when the Reset key alone is 

pressed tControl not needed)-, works only with the deladiable keyboard. 

6 Sets the exclu&iveOR/Lock- Shift mode. CWith the Caps Lock key down, you lype 
lowercase characlcts when, you press the Shift key.) 

5 Reserved, 

4 Buffer keyboard mode 

5 Enables 4X repeal instead of dual (2X) repeal. CWhcn The Control key is 
pres.!jed, ihG repeat speed for arrows is four limes the normal speed.) 

2 Includes the Space bar and Delete key on dual repeat (When the Control key is 

pressed, the repeal speed for Space bsr, Delete key, and arrows is doubled.) 

I Disables ADB mouse autopoll (disables the mouse), 

Disable* ADb keyboard autopoll (t^sabtes the keyboard], 
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Sol Configuration D/tes, $06 

This command 5el5 configuration bytes. This ts a 4-byie command C%O<XX)0llO) thai 
uses the 3 bytes foUcfwing [he commana as follows: 



Byt* 


\ 


High nibble 
Low nibble 


By1« 2 


High nibble 


LfKw nihhlp 


Byte 3 


1 iigh nibble 



1 
2 
3 
4 


1M sec 
1/2 «ec 
3/4 sec 
1 sec 
No repea[ 


Low nibble ! 


Q 

1 
2 
3 
4 
5 
6 
7 


40 keys/sec 

30 keys/sec 
24 keys/sec 
20 keys/sec 
IS keys/'sec 
11 keys/sec 
8 keys/sec 
4 keys/sec 



ADB mouse addresjs 
ADB keyboard address 



Sets character set (needed for certain languag&O most significant bit il 
keypad "," swapped with '," 



Sets deliy to repeat rate O biisj 



Seis auto^repeai rate G biis^ 



Table 9-2 lists the keyboard language codes used for byte 2 of the Set Coni^gufatinn 
Bytes command, 

Table 9-7 

Keyboard longuage codes 



LonguaQB 


AbbravlDtJon 


Cod* 


Languofl* 


AbbravkttiDn 


Codtt 


EnslEsh (U.S.) 


US 





Italian 


IT 


s 


English (U.K.) 


UK 


1 


German 


GR 


6 


French 


FR 


2 


Swedish 


SW 


7 


Danish 


DN 


3 


Dvorak 


DV 


S 


Spanish 


SP 


4 


Canadian 


CN 


9 
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Sync, S07 

Tliis command pcrfofms three of the preceding commands in sequence. It sets the 
mode b/te Csee "Sec Modes, 504" and "Clear Mcvdes, S05") followed by the Sel 
Configuration Bytes (see "Set CDnfiguraiicin Bytes, 506"). This command is issued by 
[te S-ysterTi afiGf a reset operation. After receiving the command, the micracon droller 
texts itself to its Internal power-up state and then reseis ail ADB devices. Sync is a 
1-byie command wiih a value of^OOOOOUl. 



Write Microcontrotter Memory, $08 

Tliis coaimand writes a value into the ADB mi crocontf oiler RAM, It is a 3-bvte 
ffifnmand- The first byie has a value of %000O100O, The second byte is the address to 
write into. The third byte i* iJie value to be written. 



RaacJ Microcontroller Memory, $09 

Tliis command reads a byte Trom the ADB mlcroconiroJlcr memory. The command 
leads BOM or RAM locationSn depending on the value of the high byte of the address 
sent for reading. This is a 3'byte command. The value of the first byte is %OO0Cnooi. 
Tlte second byte is ihe low byte of the microconiroLer address, The ihird byic is the 
Wgh byte of Uie miciocontrollcr address, If the third byte is 0, RAM is read; otherwise^ 
ROM is read. This command returns 1 byle. 



Read Modes Byte, $0A 

71ixL5 command reads ihe modes byte Csee "Set Modes. SQ4' or "Qear Modes, S05")- 

Itisa I'byte command with a value of %QOOOlQlO_ It returns 1 byie. 
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Read Confrgurcrtlon Bytes, $0B 

This command reads configuration bytes. Tl is a 1-byte command with a vaSue of 
%0000l0] L This command returns to the 65CSI6 (ihrmigh ihe data latch in the CLLO a 
total of 3 byies (presented one at a lime for reading by the 65C816) representing the 
most recently set conRguration Cfrom [htt mo.si recent Set ConliguraUu-n Byies 
command). The 3 bytes are returned in the following sequence: 



ADB mouse address 
ADR keyboard address 



Sets charaaer &eL (needed for certain languages} 
Scls keyboard layout language &ee Table 9-1} 



Sets delay to repeat rate 3 bii*) 



High nibble 

Low nibble 

Byte 2 

High nibble 
Low nibble 

Byle i 

High nibble 

1/4 sec 

1 1/2 sec 
1 V4sec 
5 1 sec 

4 No r^^peai 

Low nibble Sets auto repeat rale (3 bits) 

1 30 keys/sec 

2 2^ keys/sec 

5 20 kqys/sec 
A 15 keys/'scc 

5 n keys/sec 

6 8keys/i?ec 

7 4 keys/sec 



Read and Cfear Error Byte, SOC 

This command reuirns the ADB terror byte to the data latch in the GLU- It clears the 
ADB error byte la zero It L^ a 1-bytc command Tvith a value of %00(K>11(X>. This 
command is useful for hardware developers debugging new ADB devices. 



Get Version Number, $0D 



This command retumst the device version number into the data latch in the GI-U. lit is a 
l^jyte command with a vaJue or*fcOQ001101. 
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Read Available Characler Sets, $0E 

TTiis ifksLmction readj available character sets. It i^ a 1-byte command 'with a value of 
%000O111O. The Tirsi byie value retumed specifies ho-w many characicr-sel idenLifiers 
follow thLS first byte. Subsequent byies retumed Llirough the data latch identify the 
character sets. ITiis command i& used by ihc Ckintroi Panel to delennine which 
diaiacter sets are available In the system. It is assumed that each rnicr&conLfoller is 
paired with a specific megachip However, when the Apple llf^S is manufaciufcd. ihe 
factory may install on£ type of megachip and a differeni type of microccmtroHer. "fhis 
ccniiiniiid allows the system to correctly match the capabilities of the megschip wiili 
the microconiroller thai is actuaJly instalied in the system. 

The Older in which ihe character sets arc returned is imponant. The first number 
returned corresponds to character set in the megachip; the next number 
corresponds to character set 1 , 



Read Avaifable Keyboard Layouts, $0F 

This command (%00001111) rtsiums the number of keyboard layouts available. This 
command i% used by the Control Panel to determine which keyboard layouts are 
available in the system, like the Read Available Character Sets command, the order in 
which the numbers are relumed is smpcjnant. The first number rctumedl repre5cni5 

layout in the rniaocontroller. 



Reset the System, $ 1 

This command resets the system and pulLs the reset line low for 4 milliseconds. It is a 
1-byte command with a value of %00010COO, 



Send ADB Keycode, $11 

this command is used to emulate an ADB keyboard by acceptinR ADB ktjycridGS from 
1 device and then sending ibem la the microcontroller Uj be processed as licystrokcs. 
This command does not process cither reset-up or reset-down codes; these reset 
keycodes must be processed separately. This command can be u^ed in detect key-up 
events or to emulate a keyboard with another device, such iR might he used for the 
handicapped Tliis is a l-hytn command. iTic first byte has a valje of '^/flOOOlOOnV, the 
second byte contains the keystroke to be processed. See ihe Apple /fcs Hardware 
Refartnceff^r details abonjt the values that correspond tC) specific key-down, key-up 
sequences. 
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Reset ADB, $40 

This command pulls Lhe ADB low for 4 milliseoDnds- Care muSE be laken with this 
command because rescuing an ADB keyboard dears any pending commands, 
including all key-up events, This mean.9 that if ihis command is issued as a result of a 
key being pressed, when ihe key is released, lhe key-up code will be lost and the key wEll 
autorepeat until anoiher key is pressed All kej^ should be up before this command is 
execyied, This is a l^byte CDHimand with a value of %01CICIOOOO, 



Receive Bytes, $46 

This command is used to receive daia from an ADB device. This is a 2-byte 
command. The Hrsl byle value is %0lDOlOOO. Tlie second byte vaEue is a combination 
of !he ADB command Csee the Af^ie UdS Hardware Reference) in [he high nibble 
and ihc device addres in the low nibble. The microconlroller sends this ADB 
command byte on the ADB and then waits for the device to reium data. The 
microcontroller then rctLirns the data byles lo the sv'stem in [he opposite order that 
they were received from die ADB. {The issuer of [his command must know aboul ADB 
commands and the values they returnj 



Transmit num Bytes, $49-$4F 

This command ii used lo transmit data to an ADB device. This is a 3- to 9-by:e 
command, The fir^i byte value is tlic Transmit command itself and ha,s a value of 
^]Oainum, where num is a .sei of 3 binary bits that nipresent a number. The value of 
(num + O specifics how many data bytes will be iransmitted as pajrt oi" thi^ command. 
The second byte value is an actual ADB command. The third and subsequent bytes 
(num + 1) arc bytes that are transnuEtc-d direcily to the devices on the ADB bus 
immediately following the ADB command, 



Enabfe Device SRQ. $50-$5F 

Tliis command enables an 5RQ (service request) on the ADB device at address abcd. 
It is a 1-byie command with a value of 'KOlOlabcd. 
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Flush Device Buffer. S60-S6F 

This, comma, nd flushes the ADli device buffer at address abed. 1: is 3. I -byte command 
wiEh a viJue of %01iOabcd 



I 



Disable Device SRQ, $70-$7F 

This command disables Lhe SRQ on an ADB device at address abed, ti is a T-byte 
cofDinand with a. vaJue of %01llabc.d 



K 



Caution 

If data Is pendiriQ wtien tHs command ^s executed, ttie pending data could be 
lost. For sirampl©. \t SRQ Is disabled on the ADB keyboard, then oH key-up codes 
could be lost. See 'Reset ADB, $40/ 



Transmit Two Bytes, $80-$ BF 

This command Lransfers 2 bytes (jf (laia ^4ati 3nd stgfu§ jnfQrmsHon} frOm i spcdfic 
device using ihe ADB Listen command (see [he Apple IIGS Hardware Refer&nc0. Ii is 
1 l-byre command with a value of %lOxyibcd, where xy is [he i^gistcr number and 
A^cd is Ihe device address. 



I 



Poll Device. $CO-SFF 

Tliis command is used la gel dala from a specific device. Il uses the ADB Talk 
mmmand. After the Talk command is cKecutcd, the microcontroller waits for the 
deificc to send back data or for timeoui. The micfoconifoller wai[5 until all data has 
beer received and ihen returns a status byte (see Table 9-3) to Lhc system indicaiing 
the number of bytes rcctived and then returns the data. Ii returns the bytes in an nrder 
Dppajiie that in which Jiey were received by the ;M>B. "Hiis i.^ a l-byte' command with 
lvalue Dr%n3cy3bc<if where xy is the register number and abed is the ADB device 
Address. 

♦ Note: A31 commands (except the Sync command} that require more than 3 1 byte 
iransfer automaticaUy return timeout in 10 miJIiseconds if there is no response. The 
Syne command may require 20 milliseconds to process the ADB address byte 
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Microcontroller status byte 

The ADB micrcicomroller sends a status byle to the system when it detects one of the 
conditions listed in Table 5-3. When iliie system receives the microcomj'oller stalus 
byie, a sysiem interrrupL occurs. 'l"he system then determines which of the conditions 
caused the iJitcrmpt and jumps lo the appropriaie veaor. 'Ilie responses to these 

Lniernjpis are as foSJowsr 

■ Response byte: Jumps to the response vector and pr[.>ce55C5 incoming data from 
iht: microconlroller. 

■ Aborc/flush; Jumps to the abort vector and attempts to resynchroniKe ibe system 
with the Apple DeskTop Bus^ if this fails, a system cnor occurs. 

m Di^ktop Manager key sequence: Jumps to the Desktop IVIanager vector, 

■ Flus^h tniJIier key sequence: Jumps to the Hush buffer vector, 

n SRQ: Jumps lo the SRQ handler that Ls used to gather daia from the ADB devices, 
CThd5 inienupi occurs if the device has some data that it wants to transmiL Th& 
device generates a service request to catch the attention of the mlcrDcontroller.) 

Tabia 9-3 

Sfatijs byta returned by microcontrotler 

i\! condition 



7 Response byte if set ^ oiberwise^ status byte 

6 Abort/flush 

5 Desktop Manager key sequence presaed 

4 Flush bulfef key sequence pressed 

3 SRQ valid 

2-0 If ail biM are clear, then no ADB data is valid-, if data is available, then the bits 
indicate tfic number of valid bytes received minus 1— between 2 and 8 bytes 
total COOl means 2 bytes ready, Oil means 4 bytes, and so on). 
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This chapter describes ihe Apple IIGS mouse nrmware. Yau can read the mouse 
posiLion and ihe status of iha itiqum buttons using ihifl firmware. 



ImpoHant 

The material In Ms manual regaiding soft switches ond hK3fdwQre register? for the 
Apple llGB. mouse Tirmwars l5 provided for Infomatton orliy. AppllcoHore must use 
tt^e nrmwcse calls only If thtey wish to be compotible vAVh the mouse device usecf 
In all Apple II systarns, 



TTie Apple IlGS mouse is an Intelligen: device thai uses Uie Apple DeskTop Bus CADB3 
lO Communjcate with ihe Apple llcis ADD rnicroconiroUer "This is 2 deparLure Trom 
the AppleMojse^M card and the Apple lie mous*i interface, each of which depends 

extcnsivtiy un Hmiwace 10 suppon ihe mouse. Tlit Apple IIGS mouse rinnware has a 
tme passive mode liku the AppieMousc, hui it dilTers Trom the Apple lie mouse, which 
requires interrupts 10 flinciion 

Certain devices, to operate properly, must be the sole source of Interrupis within a 
sysiem because they ha^-e criticaE Limes during which they require JrTimf!diat(L- service 
by the microprocessor. An imeroipting commumcaUons card i^ a good example of a 
device that has a triiical sej-vice interval. If ii is not serviced quickly, characters might 
be lost. The uue passive mode permits such devices to operate conecily. 'llie passive 
mode also prevents Ihe SSCSlG from liein^ oi'erburdencid with inierrupis from the 
mouse firmwans, as can occur in the Apple He if the mouse is moved rapidly while an 
application prugrgm is running. 

The Apple IlGS mouse flrinwaze Can cause an iniermpt only if all of the following 
conditions are true: 

D The interrupt mode is selected. 

o The mouse device is on. 

n An inlcffupi condition has occurred. 

a A vertical blanking signal CVBL) has occurred. 

Unlike ihe Apple Uc mouse, which interrupts whenever the mouse device is moved, 
the Apple ITGS mouse device intermpts in synchroniaauon wjih the VllL. Tlits 
ausomatically limits the toLkl number of mou^^e firniware interrupts to 60 per st^cond, 
cutting down on the overhead the mouse device puts on the 65CSl6. If an interrupt 
condition (determined by the mode byte setting) occurs, it will be passed to the 
65CS16 only when the next VBL cxicurs. 



Warning 

Because ttn& mouse lirmw^jre information Is updated only once eoch vertical 
fcjanking Interval, your program mu&l be certain that at least one vertical 
blanking interval hos elapsed between mouse reads if It expecfs \o obtain n&'vii 
Information from the mousB device. 
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Mouse position data 

when the mciuse is moved, data is returned is a delta move as compared to its 
previous position, where the change in X or Y direoion can be as much 15 to ± 63 
counl5. 'Vhe maximum value of 63 in either direction represenLs approximately 0.8 
inch of Irs-vel. 

♦ A'ote,' A delta move represents a number of countjs change in posiiiDn as compared 
to ihe preceding position, thai the mouse occupied. The Apple ifos mouse firmware 
converts this relative -position daia (called a delta) to an absolute position 

The mouse device also provides the following infomiation to the mouse firmware: 
a curreni button and button 1 data CI if down, Q if up) 
n delta position since l^t read 

* Note.- At power up or rese[, the GLU chip enters a noninlerrupl state and also turns 
the mouse iRlerrupl* off. 

The ADB microcontroller auiomadcally processes mouse dat^.. The mlcrocaniroller 
periodically pollj; tlic moust to check for activity. If the mouse device is moved or ii5 
button is pushed, 2 bytes are sent lo the jnicroconuoiler. The microcantroEler sends 
bolh mpuse data byl-es to (he GLU chip (byte Y rollo-wcd by byte X; this enables the 
interrupt). The 65Cai6 then checks the status register to verify that a mouse inLerrupi 
his occurred, the 2 data bytes have been read, and mouse byte Y was read first. The 
GLU chip clears the interrupt when the second byie has been read. To preveni 
[)vem:ns, the microconiroHer writer mouse data only when the registers are empry 
(after byte X has been read by the system). Table 10-1 shows iJie 16 bits reLurned by the 
Apple IIGS mouse firmware. 

Table 10-1 

Apple llGS mouse data bits 



Bif 



Function 



Button Q staluii 

¥ movement (negative * up, positive ■ down) 

Button 1 staiu.^ 

X movement (negative = left, positive = right) 



Mouse posltton data 




Regbter addresses— fbm wore only 

Tabic 10-2 shows ibe contents of the register addresses that the ADB micrciconLroIler 
uses lo transmit AppJe ncs mouse data and status Jnformallon to the S5G816. 

Table 10-2 

^pple llGS mouse feglst&r oddresses 



Addfes!^ Function 


SC027 GLIJ status register, defined as follows; 


Bit = d 


Must not be altered by mouse 


Bit ] - 


X j>ositif)n available (read only) 


mi-1 


Y position available (read only) 


Bit2=k 


Must not be altered by mouse 


Bit 3 - k 


Must not be altered by mouse 


Bit v( = d 


Must not be altered by mouse 


Bit 5 - d 


Mual not be altered by mouse 


Bit 6 - 1 


Mouse inierrupt enable (read or write) 


Bit 7 - I 


Mouse rcgiai&T full Cread only] 


k 


Used by keyboard handlers 


d 


Used by ADB handier^ 



$C024 Mouse data register: 

Fiist read yields X position data and button 1 data. 
Second read yields Y position data and button data. 

To enable mouse IntermpLs, set bit 6 of location IC027 lo 1. Recall, however, that only 
this bit and no othtr should be changed. This entails reading the current contents, 
changing only that single bit and then writing the modified value back into [he register. 

If mouse interrupts arc enabled, the firmware determines whether ilic inierrupt came 
from the mausG by reading bits. 6 and 7 of $C027; if both bits ■ 1 , then a mouHe 
interrupt i* pending. 



■heading mouse position data— nrmwofe only 

JhG following sequence of steps must be laken, m this exact order, for accu/ate mouse 
readings to be obtained. Failure; lo perform the steps in tfiis order wit] necessitate 
some corrective action because the data will be coniaminated. Conuminated data is a 
condition diat occur? when the X and Y vaEues Ihat you are trying to read are from 
different VBL reads of the mouse. 

n Read bit 7 of 5C027. 

If bit 7 = 0, then X and Y data is not yet available. 

If bit 7 - ] , then data is available, but could be coniaminated. 
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D Read bit 1 or $C027 only if bit 7 = 1. 

; If bit 1 = 0, ihen X and Y dala are nol coniaminaTed and can be read. The firsl read 
of $C024 reHirn.'i X data and button 1 data^ ihe second nKid of 5C02«1 returns Y data. 
and button data. 

Use caution when using indexed instnjctloris. The false read and write results of 
some indexed Instructiuns can caii$e X dau to be lo^i and V dau lo appear where X 
data was expected. 

If bit 1 = 1 and SC024 has not been read, ±en the data in SG024 is contaminated 
and must be consideied useless. If ihEs condiLlon occurs, perform the following 
steps: 

D Read SC024 one lime only. 

D Ignore the byte read Ln. 

Exii ihe mouse read routine without updating the X, Y, or button data. ITiis will not 
harm the program; hawcver, U guaraniees that ihe next time the program reads mouse 
posiiionSj the posidons will be accurate. 

The data byies read in contain the following information; 

i X data byte 

if bit 7 = 0, then mouse button 1 is up. 
If bit 7 = 1, then mou-se buutjn 1 is down. 

■ Bit 0—6 delta luoujie move 

If bit 6 = 0, then a posiUve move is made up to S3F C63). 

If bit 6 = 1, then a negative muvQ in two's comptemenl is made up to S40 C64), 

■ Y data byte 

if bit 7 •= 0, then mouse button is up, 
If bit 7 = ] , then mouMj button is down. 

■ Bit Q-6 delta mouse move 

If bit 6 = 0^ then a positive move i? made up lo $3F C63). 

If bit 6 ■ 1^ then a negative move in two's tomplemenl is made up lo S40 C64). 
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Position clamps 

^■■hen the mtmse moves the cursor across die screen, the cursor is allowed to move 
only within speciTied boundaries on the screen. Itiese baundanes are [he maximum 
Cursor positions on the screen in the % and Y directions, These maximum positions 
are indicated lo the finn^ware by dampis. 

Gamps are data values thst specify a maximum or minimum valtje for some other 
nriable. In this instance, the mouiic damps^ spedfy the minimum and maximum 
positions of the cursor en the screen. 

The mouse clamps reside in RAM locations reserved for the firmware You should 
oiiy access these locations using the Apple Lies loolij. 
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Using the mouse firmware 

You can use LJhe mouse fiimTiv-aiE by way of assembly language or BA5IC. 'ITiere aie 
several procedures and rules to Tollow lo be effective in eiihef language. The following 
paragraphs oudine these procedures and aiJes and give examples of ihe use of ihe 
mouse firmware from each of ihese ]aingua,ges- 



Firmware entry example using assembly tanguoge 

To use a mouse routine from assembly language, read ihe locaJon conesponding to 
the routine you warn lo call (see Tabte 1(W at the end of this chapter). The value read 
is the offset of die entry poini eo the routine to be called, 

4 A/ofe.- Intemipts must be disabled on every call to the mouse llrmware. 

The fcitlowjng assembly code example correctly sets up Lhe entry point for ihe mouse 
firmware. Note that n is the slot number of the mouse. To use Lhe code, you must 
decide which mouse firmware command you wish to use and then duplicate the code 
for each of die routines you use. For example, io use SERVEMOUSE from assembly 
code, you would replace die line SETMENTRy lda setmouse with a line that reads 
SERVEMENTRY LDA SERVEMOUSE. where 5ERVHMOUSE is SCnlJ. Table 10-'^ 
defines all of the offset locations for the built-in mouse firmware routines 

r-OEfset to SETJiOUSE ofiseL iSCm for Apple IICS) 
("Get offset into code 
;HGdify operand 
rWhere Cn = CA in ftpple lies 
;Whare n = 40 in Apple lies 
fSavE interrupL status 
jGuarantees na interrupts 
;Turn moiiae passive made on 
;JSR to d modified JMP instriiecinn 
;C = 1 if illegal-mocle-onteeeti error 
fRestoro interrupt scatua 
fExit 

/lieatore intflifupt status 
fEitit to error routine 

;Kodi£lGd operar^d for correct entry pairtt; Sci900 for 
Apple II GS 



• 



5LTH0USE 


£QU 


SCnl? 


SETHEfJTRY 


LDfl 


serHousE 




STA 


TOHOtJSE+2 




LDX 


Cn 




LDY 


DO 




PgP 






SEX 






LDA 


#&01 




JSR 


tOHODSE 




BCS 


ERROR 




PLP 






RIS 




ERROR 


PLP 






JMP 


ebkormessge 


TOHQUSE 


JMF 


5Cn00 
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Firmware entry example usrng BASIC 

To urn ihe mouse on using BASIC, execute the follov.'ing code: 



PRINT CflBSIA) ;"PP#'i" ;REM 

PRINT CHR tlj :REM 

PRINT CHR5 Ifll *"PH40" tREK 



Mmjge read>' far output 

1 turns the mn'jae oji from BASIC 

Restore screen output 



* Afckfe, Use PRINT CHR$ (4) ; "PR#3" lo relum lo SO-column mode. 

Tt: accept ojtputs from BASIC, the firmware changes ihe ouipui Un^ts at S35 3r>d S37 Ui 
poini lo SC407 and performs an INITMQUSE rcmiinc (resets ihe mouse damps lo their 
default values and posilJoa'! the mouse lo location 0,0). 

To turn the mouse qH, execute the following BASIC program: 

Mouse leady for Du'LpUI 

Q turns tlie anause off from BftSrC 

Restore scteen output 

'^PRfS" to return to SO columns. 

To read mouse position and button statuses from BASIC, execute the following code; 



PRINT 


CHRS. M! ; " 


PR#4" 


:REM. 


PRINT 


CllH 


(0) 




:REM 


PRINT 


CHRS (41 ; ■' 


P=1*0" 


:REM 


* Note: Use 


PRINT 


chr5(4) 



PRINT CHHS(4); "IN#4" 

INPUT X. y, H 

PRINT CHHS(4J; "INjtO" 



iHEM K(>'use ready for Input 
iREm t^put mouse posicior 

:HEM Return xey&oard as the Input device when mousa 
pa^it lens hav'B ttBB-n t^s-d 



'K'hcn: the mouse is turned on from BASIC {for data enuy), ihe fimiwjre changes the 

input links at S3a and $5^ to point to $C405. When you execute an INPUT statement 
while the input link Li set Tor mousse inpul^ the firm-ware perFonns a RKADMOUSE 
operation before converting the screen-hole data to decimal ASCII and places the 

converted inpul data in ihe input buffer at $200- 

In UA5IC, the mouse runs in passive mode or a noninienupt mode. Clamps are set 
automatically lo 0000-1023 (500O0-S03FF) in both the X and ihe Y direction, and 
position data In the scteen holes are set to 0. 

During cxcculion of a BASTC INPUT sialement, ihe firmware reads the posilion 
changes (deltas) from the ADB mouse and adds ifiem lo the ahsoluie po-siiion in the 
screen holes, clamping the positions if necessary, and converts the absolute positions 
in the screen holes tf) ASCII format. Tim firmware ifien places tfiai data, with the 
button U status, in the input buffer, issues a carriage return, and returns to BASIC. 

^ looter 'llie term screen holes has absolutely nothing lo do with the appearance of 
anything on the actual display. Screen holes are simply unused bytes In the memory 
area normally reserved for screen -display operations. Because screen tiolci are 
unused by Ihe display circuilry, they can be used by the firmware for olher 

purposes. 
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tieoding button 1 status 

Button 1 status cannot be returned to a BASIC prggram. This would add another input 
variable lo the inpul buffer, and an error message thai stares ?EXTRR IGNORED 
would be displayed. 

If you want to read button I status, you can use Lhc BASIC Peek command to read ihe 
screen hole that comains that data, "["he data returned Lo the input buffer is in the 
following form: 

S k1 x2 k3 Jt4 k5. s yl y2 y3 yA y5, sh BO b5 cc 

whcic 

s = Sign of absolute position 

xl . . ^x5 = Five ASCII characters indicating the decimal value of X 

yl , , ^y5 = Five ASCII characters indicating the decimal value of Y 

gb ^ Mirtus sign (-) if key on keyboard was pressed during INPUT statement 
entry and plus (+) if no key was pressed during INPUT statement entry 

BO = ASCII space character 

ti5 ■ 1 if button is pressed now and was also pressed during East INPUT 
slatemcrtt entry 

" 2 if bution is piessed now but was not pressed during last INPUT 
statement entry 

= 3 if bution is not pressed n,ow but was pressed during last INPUT 
statement entry 

= ^ if button is not pressed now and was not pre&scd during \^i INPUT 
statement entry 

cr = Carriage return (required as a lerminaLor before control is passed from 
firmware back to BASIC) 

♦ Nol& The BASIC program must reset ihi? key sliobe at $C0]0 if sb returns to a 
negative state. POKE 49l6&,Q resets the strobe. 

The rnouse is resident in the Apple lies internal slot 4. "When the mouse is in use, the 
main memory screen holes for slot 4 hold X and Y a.bso!uCe position data, the current 
mode, button 0/1 status, and inlerrupt status. Kisht additional byies are used for 
mouse information storage; they hold the maximum and minimum clamps for the 
mouse's absolute position. 

Table 10-3 shows the mouse's screen-hole use when Apple IIGS firmware is used. 
Higures 10-1 and lQ-2 show how the bits ofths button interrupt status byte and the 
mcKle byte are assigned. 
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ToblA 10-3 

Position artti status Infoimation 



Addrau 



Uit 



|fi7C Low byie of absolute X position 

MFC Lqw bytt of abSdluee Y position 

i57C Hi^ byte of absoluLc X positian 

i5FC High byte of absoluLe Y position 

t67C Reserved and used by firmware 

$6FC Reserved and used by firmware 

J77C Buuon 0/1 mierrupL status byte Csee Ftga/Q 10-1) 

$7FC Mode byte C*ee Figure 10-2) 



Figure 10-1 

Button Interrypt status byte. S77C 



Pfsvlousjv- button 1 wos up/down fO/1) 
MovemanJ interrupt 
Button 0/1 interrupt 
VBL Int^rupt 

Ci^rently, bunon 1 i3 up/down CO/lJ 
X/V moved since lost READMOUSC 
Previousty. buitork 1 was up/down [O/D 
■Currently, button l la up/down fO/l> 



a 

! 

1 



Rgui'd 10-2 

mm &¥fi, i7fs 



Mouse ofl/on (Oyt) 

Interrupt or nejtt VBL i) mouse Is moved 
Interrupt on next VBL If button is c^essad 
Inteifupt on VBL 
Reserved 
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Reserved 
ReseiYSd 
Reserved 



"Used by firmware only 
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Mouse programs in BASIC 

Two program examples are provided betow, The first example. Myuse.Move, reads 
and displays ihe mouise position iriforraalion. The second example is called 
Mou-^eDraw and atlowsyou lo make simple drawings on the .screen in low-iesoluiion 
graphics mode. 



Mouse.Move progroin 

10 HOME 

2fl PanWT "MOUSE. MOVE DEMO" 

ID PRIMT CHH^CJ] ;"PR#0'* 

50 PRINT CHR5 (3) J-IN**" 

6D INP0T ""fK,V,S 

10 VTAB lOiPRINT X;" ""(" "S" "■ 

ao JF £ > THEN GD 

SO PRiMr CHR$ {fl^ ,-";m*ci" 

100 PRIMT CHRSm ?'■pP:M"lPRI^fT CHRSiOJ 
110 PRINT CBR? [S] j"PSi<f 

CDfumcnts 

line 10 dears ihe sctech Co black:. 

line 20 prints a heading message. 

Line 30 starts up the mouse's Inicrnsl prograni. 

Line 40 tstabiishes ihat subsequent PRINT commands wj]| «nd information Eo ihs monitor 

screen. 

Line 30 establL-ihcs that the subsequent INPUT TOmmand wiJl read the mouse. 

Line 60 Itznsfevs mouse position and butian Status readjng$ lo ihc numeric variables X, Y 

and S. 

Line 70 d^play^ ihc numeric varlabic.s X, Y, and S on the 10th line of ihe monitor streen. 

Line SO wmms the program for mote mou&c dala if^ no keyboard key has been pressed. If a 

key has been pressed, ihe program drpps to line 9Q. 

Une 90 reestablLsh^s your keyboard as the input device. 

Lire IDO resets ihc mouse position data to zero. 

Line 110 reeaabl tshe-s the nnonitor screen ai Ihe output device. 

Line 120 ends the prggrara, 
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Mouse.Draw program 




jiEH HOUSE, DRAW Uses mouse to draw Ic-res qrephlca 

GQStPB IQOQ: REM TUPM QH THE MOUSE 

PRIHT CHB5H>f'"rN#'!"* 

IHPUT ''■";K,V,3 :R£H READ HOUSE DATA 

IF 3-1 THEN lOOzREH CLEAR THE SCREEN 

IF 3^0 THEN 300;REM TIME TO QUIT? 

REH SCALE HQD3E POSITIOH 

X-THTi;S(/'25.575J 

Y=IST(f/J5.57S) 

PLOT x,r 

GOTO 120 

REH CHECK EF TIKE TO QUIT 

PHIh'T CBR${^] fTN/fD" 

VTAB a2fPa.INT "PRESS RETURN TO CQNT OB ESC TO QUIT" 

VTAB 52SHTAB 3&IGET A? ! POKE -163SB,0 

IF AS=CHH^{13> THEN HOME : GOrO 110 

IF A5<:;>CHRS [37J THEH 330 

ElEH CLEW* SCREEN AND ZERO MOUSE 

TEXT: ROME 

PRINT CHRStfl) ;"PR#4"!eRISr CRRStlJ 

E"RIHT CHfl${4] j"PH#0'' 

END 

REiH Clear the screen ar.d initialize the moude 

ilOME ; QS 

COLOR - 15 

PRIHT £HR5(4i ;''PR#4":FRIHT CHHS[1) 

PRIHT CHRS(-)J;'^PRtO^' 

RETURN 



1 



I 
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CDCiuncnts 

Line lO rccninds j.'ou what the program does. 
Line 100 1r3.ll? the subroutine al lines 1000 through 1Q50 

Line 110 e&tablLshes thai Eh* subsequent INPbT command will read the mouse. 
Line 120 transferal mouse position and button Kiaiup dau to ihc numciric variables X, Y, and S. 
Line 130 reinitiaElzes the mouse if Its button 15 pit^sat-d 

line l-iO *entla (ht prograin lo fcte cx'A routine if a key on the Apple keyboard has been 
pressed. 

Line 150 reminds yaxi wKji the next two lines do. 

Lines ItiiO and 170 conven the range oi" mause position numtwrs (0 Co 1023) K> Uie lange of 
low-rcsolutbon graphics coordinates (0 Lo 40). 
Line \W plots a point on the nionitof screen. 
Line 190 sends the program back for more rroti^e data. 
Line 300 reminds you whii lines 310 through 4f>0 cto. 
Line 310 telts. the computer ■□ accept input from its keyboard. 
Line 320 prinls promptjjig instructions on line; 22 uf Uic .■iCTcr.n- 

Line 330 fetches your answer to the promjM *ndl cfiEini^is ttie button slalus number back to 
positive Cit becomes negative wKencvef you pres* a. key on eNe Apple kcyboiirdD. 
Line 3^10 sends the progrsim b5kck to reporting mouse daia if you pre&^ed Return, 
Line 350 fetcl-ies anfMher answer if you press any key except Esc. 
Line 3(t0 remlrKlfi you whai happcins next- 
Line 370 cancels graphics mode and clear.!> ihe scfccn. 
Line iSO resets the mouse position data to 7ero. 
Line 3!90 rccswiblislncs the monitor screen as the output device. 
Line ^00 ends the program, 

Line lOflO icminds you what the following .subroutine does. 

Line lOlQ clears the monitor .screen and sets up Apple's low-resolution graphics mode. 
I.lnr 1020 establishes that the cursor will be white. 
Line 1030 slarls up the mouse's Internal program. 

Lint; 1040 establishes that subsequent PRINT commands wil] send informatron to the monitor 
screen. 
Line 1050 returns to the main program <line lOD). 



208 Chapter 10- Mouse Flrrrsware 



K. 



Summary of mouse firmware calls 

The firrawafe calls to enter mouse roulines are lisled in Table 10-4. Thescr calls 
cDnform to Pascal 1,1 proiotol for peripheral cards- 

ToblA 10-4 

Mouse firmware calls 



Location 



RouMn* 



Dorinirion 



SC40D 




PINIT 


$C40E 




PEEAD 


*C40F 




PWRITE 


SC410 




PSTA'rUS 


^CAll = 


$00 




Bouilnes impiemenled on Apple IIG. 


$C412 




SETMOUSE 


$Cdl3 




SERVEMOUSE 


SC414 




ERADMOUSK 


SC-ilS 




CLEARMOUSE 


$^316 




POSMOUSE 


SC417 




CLAMPMOUSE 


SC418 




HOMEMOUSE 


SCiip 




INITMOUSE 



?ciicai flrmwar* enlry points for Ihe mouM 

Pascal INIT device (not Implemented) 
Pascal READ character (not implemented) 
Pascal WRITTi character Cnol implemented) 
Pascal gee device siatus (not implemented} 

Indicates thai more routines follow 



Sets mouse mode 

Services mouse intemipt 

Reads mouse position 

Clears mouse ptwition to Cfor deka mode) 

Sets mouse position !o user-deHned posilion 

5eia mouse bcjund** in a window 

Sets mouse to upper-left corner of clamping window 

RosGL-i mouse clamps Up default valueSi seis mouse 

posilion ID 0,0 



Entry polnte compallblfl wllh AppleMousft card: Hwy do nothing In Apple l\<ii 

Dummy routine; clears c and performs an RTS 

Dummy fouiine^ cleifs c and peffofms an RTS 

Dummy routine; clears c and perfDcnis an R'l^ 
Dummy routine, clea^rs c and performs an WVS 

Dummy routine; dears c and performs an RTS 
Dummy routine, dears c and performs an RTS 



ItiJLlal entry point wticn coming from BASIC 

BASIC input entry point (opcode SEQ Pascal ID 

byte 

BASIC output entry point Copcode CLO Pascal JD 

byte 

Pascal generic signature byte 

Apple lechnical-support EfJ by[e 

Additional ID byte 

Sunmnafv of mouse flrmwoire calls 



SC^IA 




DlAGMOUSLi 


SC41D 




COPYRIGHT 


tC4lC 




TIM ED ATA 


$C41D 




SEI"VBLCN1S 


SC4IE 




OPT MO USE 


K41F 




STARTTIMER 


Olh«f slgnirlconl locattom 


SC^OO 




BINITENTRY 


SW05 




BA5ICINPUT 


SC407 




BASfCOUTPUT 


SC408 • 


$01 




SCSOC - 


S20 




SC4I-B - 


SD6 
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Pascal calls 

Pascal iiccoigni2es ttie mouse as a valid devicei however, Pascal is rtOl supported by ibe 
Hrmware. A Pascal driver for the mouse is available from Apple to inlcrFace programs 
with ihe mouse, Pascal calls Plnil, PRcad. PWriie, and PSlatus return with the X 
regisier see tti 3 (Pascal itiegal operation error) and the carry (lag sei lo 1 . Following is a 
list of Pascal firmware calls. 



Pinit 

Functian 

Tnpul 

Output 



^fol implemented (just an entry poini in caw user calls it by mistake), 

Ail registers and status bits. 

X = S03 Ceffor 3 =' bad mode; illegal operation), c - 1 (alwayiO. 
Screen holes: unchanged. 



PRead 

Function 

Input 

Output 



Noi implemented (just an entry poin[ in case user oils It by mistake). 

All registers and status bits. 

X ■ $03 (error 3 = bad rnode; illegal operation), c - 1 Cal^^^ys). 
Screen holes: unchanged. 



PWfHe 

Function 

Input 

Output 



NoL implememed (just an entry point in case user calls it by mistake). 

All registers and status bits. 

X = SQJ (error 5 * bad mode: illegal operation), c = 1 (always). 
Screen holes, unchanged 



PStatu« 

Function 

Input 

Output 



Not implemented (just an cntiy point in case user calls It by mistake). 

All r^0[m and mm bii§. 

X - S03 (error 3 = Bad mode, illegal operation), c = 1 (always). 

Screen holes' unchanged. 
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Assembly-language calls 

This section dcsp-ibes the assembly-language Rrmwarc calls. When you use the mouse 
fj-oni a.'isqmblv language, you musi keep sevt^ral items in mind. 

D For built-in fiimware, n = mouse sloe number A. 

Q The following bits and registers are not changed by mouse fu-mwafe: 

D c, m, T, s 

n direa regisier 

Q data bank register 

n prngram bank register 

n Mouse screen holes should not bo changed by an applkailon program, with one 
exception: During execution of ihe POSMQUSI: function, new mouse coordinates 
are written by the application program directly inio the saten holes. No other 
mouse screen hole can be changed by an appJication program without adversely 
affecting the mouac, 

□ The 65C816 assumes that tlic mouse firmware is entered in the followmg machine 
slate: 

□ 65CS16 is in emulation mode, 
o Direct register = S0000_ 

D Data hank register = iOO. 

□ System speed = fasl or slow (does not matter which). 

□ Tcjtt page 1 shadowing is on to allow access to screen-hole data. 

Hera are the actuaJ firmware routines. Notice thai each is specified by its ofTsei entry 
adc!res5. Recall that the oJTset entry point is a value at a given location (for example^ 
SC-l 12) ID which you add the value of the main entry point (for example, SC-IOO) to ' 
obtaiji the actuaJ address to which the pnjcessor must jump to execute the nxiUne. 



SETMOUSE, $C412 

Functloo Set* mouse operation mode. 

Input A = mode {$00 to 50F are the only valid modes). 

X = Cn for standard Interface (Apple IIGS mouse not used}. 
y = nO for standard inierface (Apple IIGS mouse not used). 

Output A - mode if illegal mode entered; otherwise, A is scrambled 

X, Y, V, N, Z - scrambled. 
c if legal mode entered (mode is <= $0^7. 
c = 1 if illegal mode entered (mode is > $0F). 
Screen holes: Only mode bytes are updated. 



^sembly-languago calls- 
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SERVEMOUSE, $C413 

Function Tesis for inierrupL from mouse and resets mouse's Interrupt line. 

Input X 15 Cn for standard interface CApple MCS mouae not used). 

Y = nO for standard interface CApple lies mouse noi usedX 

Output X, Y. V, N. 2 = scrambled. 

c ■ if mouse interrupl: occurred 

c = 1 Lf mouse interrupt did not OCCUr. 

Screen hoJes; Interrupt status biis updated to show current sLatus- 



READMOUSE, $C414 

Function Heads delta Oi/Y) positioa*, update? absolute X/Y posiiionsn and reads 
button statuses from ADB motise_ 

Inpul A = not affected_ 

X « Cn for suindard interfare CApple IICS mouse not usedX 
Y = nO for standird interface (Apple IIGS mouse noi used). 

Output A, X, Y. V, N. Z = scrambled. 

C " (alway^. 
Screen holes; StO, XW, YLO^ YHI buttons and movemeni status biL? 

updated; interrupt status bits are cleared. 



CLEARMOUSE, SC415 

FiincUon Resets buttons, movemenE, and interrupt status toO, X, and Y. Clliis 
mode is intended for delta mouse positioning irL^iead of the normal 

absolute pos]lion[ng.) 

Input A = not affecied. 

X = Cn for standard interface (Apple IIOS mouse not usedl 
V "■ nO for standard interface CApple UGS mouse not used). 

Output A, X, Y, V, N, Z = scrambled 

c - (always). 

Screen holes: SLO, XHI, YLQ, YHI buttons and movement status bits 

updated; interrupt status bits are cleared. 
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POSMOUSE. SC416 



Function 
Infhut 



Output 



Mows user lo change cutient mouse position. 

User places new absolute K/Y positions uirectly in appropriaLe screen 

holts, 

X - Cn for standard interface CApple HGS mouse not used) 

Y ■ nO for standard interface (Apple IIGS mouse not used). 

A, X, Y, V, N, Z - scrambled, 

c = (always). 

Screen holes: U^er changed X and Y absoluLe posiLions only, byics 

changed. 



CLAMPMOUSE, $C417 



Function 



Input 



5eis up clampirtg window fpr mouse use. Power-up default values are 

to 1023 [SOOOO to S03FFJ. 

A = if entering X damps. 
A - 1 if entering V damps, 

Oamps arc entered In slot screen holes by [he user 35 follows: 

$■478 - low byte of low damp, 
$4F8 = low byte of high clamp, 
S578 = high byte of low damp. 
S5F8 = high byte of high damp, 

X = Cn for standard mierface (Apple IlGS mouse not used). 
Y = nO for standard interface (AppJe IIGS mouse not used). 

A, X, Y, V, N, 2 = BCfambled. 

c - (aJways). 

Screen holes: X/Y absolute positlori \$ set to upper-lefl corner of 

damping window. Clamping RAM values in bank SEO are updated. 

* /Voie-The Apple ires mouse firmware performs an auiomaiic HOMEMOtJSE 
operation afier a CLAMPMOUSE, HOMEiMOUSE eKccuUon is required because the 
delta informaLion is being fed lo the firmware imlead oftl'.s. a5 in the case ofihe 
Apple II mouse and Ihe 6SD5 AppJeMouse microprocessor card The delta 
information from ihc Apple lIGs ADR mou^e alters the absolute posiiion of the 
screen pointer, u^Ing damping techniques not used by the other two mouse 
devices. 



Output 



Assembly-language calls 
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HOMEMOUSE, SC4ia 

Functton Sets X/Y absolute position to upper-left corner of clamping window. 
A " not affected. 



Input 



Output 



X = Cn for standard inierface (Apple lies mouse not usedD- 
Y - nO for standard interface (Apple IIGE mouse nol used). 

A. X, Y, V, N, Z - scrambled. 

c * (always) 

Screen holes: User changed X and Y absolute positions only; bytes 

changed. 



INITMOUSE, $C419 



Fiinctlon 

Input 

Output 



SeLs screen holes (O default values and sets clamping window ly defaul 
value of 0000 to 1023 ($lXK)0, $03Fn in both [he X and Y directions-^ 
resets GLU mouse inierrupi capaNlities. 

A = not affected. 

X ■ Cn for standard Interface CApple IICS mouse not uKd). 

Y = nO for standard interface (Apple ItGS mouse not used), 

Z = scrambled. 



A, X, Y. V, N, 

c ■ (always) 

Screen hotes: X/Y positions, button statuses, and interrupt status are 

reset. 

♦ Not& Button and movement siaiuses are valid only after a READMOUSE operation. 
Interrupt status bits are valid only after 2. SERVEMOUSE operation. Intertupi status 
bits are rejiet after READMtJlJSE. Read and use or read and save the appropriate 
mouse screen-hole data before enabling or reenabling 65CS16 interrupts. 
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Appendix A 



Roadmap to 
the Apple IIgs 
Technical Manuals 



The Apple EGS personal computef has many advanced features, making it more 
complex than earlier models of the Apple II. To describe it fully, Apple has produced 
a suite of technical manuals. Depending on the way you iniend to use ihe Apple UGS, 
you may need lo refer to a select few of the manuals, or you may need lo refer to most 

■of them. 

The technical manuals are listed In Table A-l. Figure A-1 is a diagram showing the 
reJitionships among the different manuals. 
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Tdblfr A' 1 

Apple lies t>dchriilcai manuats 



T]llft 



Subjvcr 



Techriicai Jntrtidtiction to ths Apple Hcs 

Apple FIGS Hardware Reference 

Apple IIGS Firmware Reference 

Programmer's Introduction 
to the Apple lies 
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specifications 

More toolbox specincations 

The development environment 
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Loader 

Guidtlir^^ for the desktop interface 
Numerics for all Apple computers 
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FIgjra A-1 

Roadmap to thei technScot manuols 



To start finding ou1 
Q&Dut mm Apple lies 



To laam how 

the Apple JIG5 works 

To star] leorning 



to program the Apple lies 



To lisp the toolbw 



To use the tleuelopment ' 
anvlronirnent 



lo operole on llies 



To use C 



Id usa "' 

QSSemfily Jorvguage 
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The introductory manuals 

These books are introductory manuals for developers, computer cnthusiasL?, and 
other Apple IIGS owners who need technical infcirmation. As intftxluciory manuals, 

their purpose is to lielp the lechnicil reader understand the features of the Apple llGS^ 
pafticularly dhe feaiurcs that are different from mher Apple computers. Having read 
the introduciory manuals, the reader will refer to speciTic reference manuals for details 
about a particular asped of ibe Apple IIGS. 



The technical Introduction 

The Technical }ntroduciion lo the Apple IlGS is the first book in the suite of technical 
manuals about the Apple liCS. It describes all aspects of the Apple tlGS, including lis 
features and general design, ihe program environments, ihe toolbox, and the 
de\'elapmeni environment. 

'^■liere the Apple HGS Owner's Guide is an introductjon from the point of view of the 
user, the technical introduction manual desail^s the Apple IIGS from ihe point ftf 
view of the program. In Other words, it describes the things the programmer has to 
[lonsider while designing a program, such as the operating features the program uses 
and the environment in which the program njn5_ 



The programmer's introduction 

^"hen you start writing Apple IIGS progranM., the Programmer's Introduction to the 
Apple IlGS provides the concepts and guideEines you need. It is not a complete course 
in programming, onJ;^ a starting point for proBrammen* wHiing applications that use 
Ihe Apple desktop interface (with window^,, mtnus, and the mouse). It inlioduces the 
routines in the Apple Ties Toolbox and the program environment they mn under. It 
includes a sample event-driven program; thai demon-ijiratc!.^ how a program uses the 
toolbox and the operating syEtom, (An event-driven program waits in a loop unliJ it 
detetis an event such as a dick of the mouse button.) 
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The machine reference manuals 

']lierc are iwa reference manuals for Lhe miadiiiK: itself: ihe Apple UGS i tsrdware 
Reference and lhe Appie IIG'S Firmware Reference. These books coniain deuiled 
specillcatiofis for people who want lg know exactly whai's insLde the machine. 



The hordware reterence manuol 

The Appie li<s*> HardwariQ Reference is required reading for hardware developere, 
and; il will also be of inLereat lo anyont dsc; who wants Eo know how Lite madiinc wortm. 
Informaiion for developers includes the mechanical and electrical specifications of all 
connectors, both imernat and external. Information of general inieresi includes 
descriptions oF the intcmaJ hardware, which provide a better undefsianding of the 
machine's feaiures, 



The firmware reference manual 

The Apple UGH Firmware Reference descriljes the programs and subroutines that are 
stored in |.he machine's read-only memory (ROM), with two significant exception.?: 
Applesoft BASIC and the toolbox, which have their own manuals. The Hrmware 
tcfprence manual includes mformation about inierrupl routines and low-level I/O 
subroutines for Lhe serial porUS, the disk port, and tlie Appte DeskTop Bus interface, 
which controls the keyboard and the moust! The manual also describes the Monitor, a 
low-level progiamming and debugging aid for assembly-language programs. 



The toolbox reference manuals 

Like the Macintosh, the Apple IICS has a built-in toolbox. The Apple Ugs Toolbox 
Re/erETice, Volume 1, introduces Concepts and terminology and tells how to use some 
of the tools. The Apple ilCS Toolbcac Reference, Volume 2, contains information 
about the rest of the tools and a,lso tells how to write and install your own lool seL. 

Of tourae, you don't have to use the toolbox ai ail If you only want to write simple 
programs thai don't use the mouse, or windows, or menus, or other parts of the 

desktop user interface, then you can get along without the toolbox. However, tFyou are 
developing an application that uses the desktop interface or if you want to use the Super 
Hi-Res graphics display, you'll find the toolbox to be Endispensahle. 

In applications that use the desktop user inteifacej commands appear as options in 
puli'down menus, and material being 9/ofked on appears in rectangular areas of the 

screen called windows. The user selects commands or other material by using the 
mouse to move a pointer around on the screen. 
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The programmer's workshop reference manuaT 

The Apple IIGS Programmer's Workshop (AP^ i-s ihts dcvcEopment environmem for 
(he Apple IIGS computer. APW is a set of programs thai enabtts developers lo create 
and debug apptlcalion programs on the Apple IIGS. The Apple uas Pitfgmmmer's 
Workshop Reference includes JnformaLion abaut the APW Shell, Ediior, Linker, 
Debugger^ and utility program^; Lhcsc aire the parts of ihe wofkiihop ihat all developers 
need, regardless oF which programming language they use. 

The APW reference manual describes ihc way you use the workshop to crcaic an 
appUcation and includes (ixamplcs and illuscraiions to show how diis is done, In 
additinn, this manual documents the APW Shell to provide the informaijon necessary 
lo write sn APW utility or a language compiler for [he workshop. 

Included in the APW reference mmua] are complete descriptions of two standa/d 
Apple IIG5 Rle formats: the text fi.le format and the ob]ecl module rormaL The text file 
format is used for i^ll Tiles written or read as "standard ASCII files" by Apple llCS 
programs running under ProDOS Id The objea module format is used for the ouptut 
of all APW compilers and fcr all files loadable by the Apple ilCS System Loader. 



The programming-language reference manuals 

Apple currenUy provides, a ■S5C8I6 assembler and a C compiler. Other compilers can 
be u^d with the workshop, provided that they follow the standards dcfmed in the 
Apple ffOS Programmer's V^ork-shop Reference. 

Tliere IS a separate reference manual for each profiramming language on the 
Apple IIGS. Each manual includes the spedfications of the language and of the 
Apple IIGS libraries for the language, and deicribes how to use the assembler or 
compiler for tliat language. The manuals for the languages Apple provides arc the 
ApplB IFGS PmgTammer's Workshop Assembler Reference and the Apple FIGS 
Programmer's Workshop C Reference. 

The Apple HCS Programmer's Workshop Reference and the two programming- 
language manuals are available dirough the AppEe Programmer's and Developer's 
Association* 
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The operating- system reference manuals 

There are iwo operiLing sysienis that run on ihe Apple IIGS: ProDO^S l6 and 
ProDOS 3. Each operatinK syslem Ls described in iis own manual: ProDOSS Technical 
Reference Manual and AppiellGS frolX)S 16 Reference. ProDOS 16 uses Ihe ftiU 
power of the Apple IlGS The PrnDOS l6 manual describes tis feaiure* and includes 
ififormalio-n about ihc System Loader, which works dosely wiJi FraOOS l6. IT you are 
writing programs for the Apple hCS,, whether as an application programmer or a 
system programmer, you are almost certain to need ihe ProC>OS l6 rcfcrtncc manual. 

ProDOS 8, previously just csllcd ProDOS, is the standard operating sy.'jtem for most 
Apple II computers with S-bit CPUs CApple lie, He, and 6^K II Plua). U also mm. on the 
Apple IIGS. As a de%'e!oper of Apple JIGS pfograms, you need ihe ProDOS S Technicai 
Se/er^nce Manual only if you are developing program^ lo run on 8-bit Apple U's as 
well as on the Apple IIGS, 



The alE-Apple manuals 

In addition to the Apple IIGS manuals meniioned above, there are two manuals that 

apply to all Apple computers: Human Inferface Guidelines: Thi^ Apple Desktop 
Interface and Apple Numerics Manual if you develop programs for any Apple 

computer, you should know abotat ihose manuals. 

The Human fntejface Cuidetiues manual describes Apple's standards for Ihe desktop 
[nierface of a.ny program tliat runii on an Apple computer [f yau are writing a 
commercial applicacion frjr the Apple IlGS, you should be fully faimlliar wiih ihe 
contents of this manual, 

The Apple Numerics Manual is the reference for the Standard Apple Numeric 

Environment CSAI^^E™). a flill implementation of the fEEf^ Standard for Binary 
Flcali-ng-Poim Ariihmciic CIEEE Std 15^-\9&5\ 'Ihe functions of the AppSe IlGS SANE 
toot set match diost of the Macintosh SA.NE package and of the 6502 assembly- 
linguagc SANE software. If your application requires accurate or robust arithmetic^ 
you'll prc±ably want to use the SANE routines in the Apple IIGS, 'llie App!e Has 
Toolbox Reference leSls how lu use the SANT routines in your pro-ams. The Apple 
Numerics Manual iz the comprehensive reference for the SANE numerics routines. 
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Appendix B 



Firmware ID Bytes 



■Hte fmrm^^re TD bytes are used tn identify Ltie particuSaf hardware svslem on which ynu 
are currently working. Table B-1 lists (he locaiions from which you can read ID 
informatton, Eadi sysiqm maJnLains three separate ID byte locations, as indicated in 
the tihie, If alE ihree ID bytes maidi for a given s^-stem type, you wai know that your 
software is running on [hat p^riicular systctn. 



Tabl9B 1 

ID InJormatton loca-tfars 





Main IP 


Sub ID 1 


$Ub ID2 


&ytt«m 


(iFBb^) 


(FBCOJ 


(iFB&f> 


Apple II 


$38 


S60 


$2F 


Apple H Plus 


S!iA 


SEA 


$EA 


Apple He 


506 


$EA 


5C1 


Apple Ra Plus 


&Q6 


SRO 


300 


Apple IIG5 


S06 


$E0 


500 


Apple lie 


Sq6 


ioo 


5FF 


Apple Uc Plus 


506 


$00 


500 



To distinguish ihe App[e Ifcis fnjm an Apple Jle Plus ([he ID bytes are ideniica.D, run 
die following short routine, with the ROM enabled in the kng,-uage card. 

,-c - 1 as a starting paint 
fBT5 for ApplK II computers 
;prior to the Apple ires 

,-If c - 1, then the syatCBi is an old Appte 11 
;If c = D, then the system is a Appie IIgs or Later and the 
registers are retiirned with the inEcirmation in Table fl-2. 



E£C 




JSR 


SFEIF 


BCS 


ITSAPPLEI1£ 


BCC 


IT^SAppLellGS 



Toblfl B-2 

Register btt fnformaHon 



I*gl4l«r 


BI1 


InfDimatlon 


A 


15-7 


Reserved 




6 


1, if sysiem has a memory expansion slot 




5 


1, if system has an IWM port 




4 


1, if system has a b\ii]\-in dodc 




3 


1, if syslem has Apple DeskTop Bus 




2 


1, if system has SCC 




1 


1, if system has extern al slois 







1, if syslem has internal ports 


Y 


13^ 


Machine ID: 

00 Apple IJGS 
1-FF Future machines 



X 7-0 ROM T-erslon number 

The V register contains the machine ID^ the X register contains the RON! version 
number. 

<« Note; If ^lie ID call was made In emulation mode, only the low S bits of X, A, and Y 
are returned correctly; however, the c bit is accurate. If the call was made in native 
mode, the c bit as weL as register informaijon 15 accurate as shown in Table B'2 and 
is returned in full l6-bit naiivf; mode. The c bit is the carry bit in the procsASOf status 
regLs^er. Tf the value returned in V is $00, the value in A should be considered to be 
S7F. 
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Appendix C 



Firmware Entry Points 
in Banic $00 



Apple Corripuler, Inc. will mainlajn Ihe entty poiiiK described within [hi5 documeni 
In any lidture Apple IIGS or Apple n-compaLible machine thai AppEe produces. No 
other entry points wiU be mainLained L'sfi of ihe entry points in ihis document will 
ensure compaLibilily with Appie OGS and future Apple Tl-cocnpatiblc machines. Noie 
that these entry points are specific to Apple ITc»s and Apple IlGS-compatible machir^es 
and do not necessarily apply to Apple lie or Apple lie machines, 

As an alternative iq using these entry poinis, note that ytXi can also use the 
MisccllaneDUS Tool Set FWENTRY firmware fiinction. 

For alloflhe routines dcfmed in this chapter, the following definitions apply: 

D A represents the lower 8 bits of liie accumutatoj-, 
a B represents the upper S bits of the accumulator. 

□ X and Y rcpreseni S-bit index reaisters. 

□ DBR represents the data bank register. 
n K represents the program bank register. 
n P rcpjesents the processor status register 

□ S represents the processor stack register. 
a D represents the direct'-page register. 

a e represents the emulation-mode bit 

□ c represents the carry flag. 

D ? represents a value that is undefined 



^ 
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Warning 

For ail of ttie routines In this appendix, the followtng ©nvlronmervt variables must 
be set w!th ttie values shown tier©: 

c The e bit must be set to 1 . 

D the declmcl mode miis-t be set to 0. 

n K must be set to SCO. 

D D must tie set to SQOOO, 

3 OBR must b& set to SOO. 

fotlowing are descriptions of the flrmwafc routines supported as entry points in 
curren! and future models of the Apple IT famtly, slaning wiili the Apple ItGS. 

SFBOO rLOT Plot on the low resolution screen only. 

PLOT puis a single block of the color value set by SETCOL on the 
low-resoluiioo display screen. 

Input A ^ Block's vertical position (,Q-$2Ty 

X- ? 

¥ - Block's horizontal position CO-S27) 

Output Unchanged - X/Y/DBK/K/D/e 
Scrambled - A/B/P 



5F80E PLOTl 



Modify block on the low-resolution screen only. 



PLOT puts a single blwek of ilite color value set by SETCOL on Uie 
low-resolution display screen. The block is plotted al current settings of 
GBASL/GBASH with cun^ent COLOR and MASK settings 

Input A - ? 

X = ? 

Y = Block's horizontal pcsition (0-S27) 

Output Unchanged = X/Y/DBR/K/D/e 
Scrambled - A/B/P 



/ 
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SFE19 
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HLINE Praw a horizontal line of biocks on low-r&solulion screen 

only. 

HLI^fE draws a horizoirital line of blocks of the color sei by SETCOL on the 
low- rescjlu lion graphics display. 



Input 



Output 



$re2S VLINE 



A =5 Block's vertical posiiion C0-$2F) 
X = ? 

Y - Block's Icrtmost hori^onial position C0-$27) 

H2 - (Address ^ S20; block's righiracjst horizontal position 

C0-S27) 

Unchanged = X/DBR/K/D/e 
Scrambled - A/Y/B/P 

Draw 3. vet^csl line of blocks on the low-fesQluiion screen 
only. 



VLINE draws a vertical line of blocks oFihe color a?t by SETCOL on ihe 

low-resoIuUon display. 

Input A - Block's lop vertical posiLion C0-S2I0 

Y = Block's horizontal position (0-527) 

V2 - (Address = S2D>i block's bottom vertical position C0-$2F> 

Unchanged = X/DDR/K/D/e 
Scrambled - AA'/B/P 

Clear the low-resolution screen only. 

CLRSCU clears the low-resolution graphics display to black. !f CLR&CR is 
called while the video display is in lexi mode, it fills the screen with inverse 
al sign C0) dharaaers. 



Owtput 



SPSS 2 CLR5CR 



Input 



A = ? 
X = ? 
Y ^? 



Output Unchanged = X/DBR/K/D/e 
Scrambled - A/Y/B/P 
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$F836 CLRTOP Clear the lop 40 lines of the low-resolulion screen only. 

CLRTOP dears ihe Lop 40 lines of the low-resolulion graphics display On 
mixed mode, clears the graphics porUon of the screen to black). 



Output Unchanged - X/DBK/K/D/e 
5crambl<;<l = A/Y/B/P 

SF847 GBASCALC Calculate base aiddress for low-resolution graphics only. 

GRASCALC calculates Uie base 34dress of the line on which a particular 

pixel is to be plotted. 

tnpat A = Vertical line to find address for [0-S2F) 

Y = ? 

Output Unchanged = X/Y/DUR/K/D/e 

Scrambled - B/P 
Special - A = GBASL 



SFSSF 



NXTCOL 



Incremeni color by 3, 



NXTCOL adds 3 Eo the current color (sel by SCTCOL) used for low-resolution 
graphics. 

Input A - ? 



Output Unchanged - X/Y/DBR/K/D/e 

Scrambied = B/P 
1 SpedaJ = A = New coior in hi^ or low nibble 
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3F864 SETCOL 



Set low- resolution gr2phjcs color. 



r 



SETCOL sets the color used for plotting in low-iesoluuon graphics. The 
colors a/c as foUc^w.;; 

SO = Black 
S3 - Deep red 
J2 ^ Dark blue 

13 = Purple 
$A = Dark green 
$5 " Dark gray 
$6 = Medium blue 
il - light blue 
$8 = Brawn 
S9 = Orange 

SA - Light gray- 
SB ^ Pink 
SC = Ijghl green 
SD = Yellow 
SE - Aquamarine 
SF = While 



l&C 



Input 



Output 



$Fe7i satN 



A = Low nibble - new color to use; high nlbWe doesn't matter 

X = ? 

Y-? 

Unchanged - X/Y/DBR/K/D/e 

Scrambled - B/P 

Special = A - New color in high or low niibbJe 

Read the low-resolutjon graphi'i:^ screen only. 



SCRN returns the color value of a single block on the low-resolutton graphics 
display. Call it with the vertical position of the block in the acojmulaior and 
horizontal position in the Y register. 

Input A = Vertical line lo find addr for (O-SZIO 
X - ? 
Y = ? 

Output Unchanged = X/Y/DBR/K/D/e 
Scrambled - B/P 
Special " A ■ Color of block specified in low nibble; 

high nibble ■ 



1^ 
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JF8SC INSDS1.2 Perform LDA CPCL.X); then Fall Into INSDS2. 

INSDSI.2 gets the opcode to deifinnine the itisiructton length of wiih an ^DA 

CPCL,K1 and falls into rNSDS2. 

Input A = ? 

X - Offsei into buffef al pointer PCITPCH 
Y-? 

PCH = (Address $3B) hjgh byte of buffer address to get opcode 

from in bank SOO 

PCL = CAddfcss = S3A} low byte of buffer address to gei opcode 

from in bank $00 

Output Unchanged ^ DBR/X/D/e 
Scrambled = A/X/B/P 
Special = Y = SOO 

LENGTH (addiESB = S2F>5 contains Lnstruclion length 1 
of S502 insLnictions or - SOO if nol a 6502 opcode 



SFSSE INSDSZ 



Calculate length of 6502 [nstruction. 

INSDS2 determines die length 1 of the 6502 instruction denoted by ihe 
opcode appearing in the A register. 

INSDS2 returns correct instruction length 1 of 6502 Opcodes only. Al! non- 
6^02 opcodes return a length of $00. For compatibiliLy reasons, the BRK 
opcode returns a lengda of JOO, not $01 as one would eipect it to. 

Input A " Opcode for which length Is to be determined 

x = ? 

Y-? 

Output Unchanged = DBR/K/D/e 

Scrambled = A/X/B/P 

Special - ¥ » $00 

LENGTH (addms-^ = S2F); contains instruction length 1 
of 6502 instnictions or = SOO if not a 6502 opcode 
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SFa90 CETeiGLEN Calculate length of S5CST6 instruction, 

GETSlSLKN deiermines the length of the 65RI6 insinjciion denoied by the 
opcode appearing in Uie A register. The BRX opcode fctuifns a length of SOI 
as one would expect it to. 

Input A = Opcode for which length is lo be deiennined 

X- ? 

Y = ? 

Output iJnchansed = DBH/K/D/e 
Scrambled = A.'^/B/P 
Special - Y = SOO 

LENGTH (address ' S2F}; contains instruction length 1 

of 65CSI6 instnactions 

SF8D0 INSTDSP Display disassembled instfuction, 

INSTDSP disassembles and displays one Instrucijon pointed to by the 
program counter PCL/PCH (addresses 5iA/'S3B) in banlc %QQ. 

Input A = ? 

X= ? 

Y = ? 

Output Undianged = DBR/K/D/e 
Scrambled = A/X/Y/B/P 



5F9^a 



PRNTYX 



Fruit coritenis of Y and X registers in lie* rormal. 



PRNIYX prints the contents of the Y and X rcgislisrs as four-digit 

liexfidec-ima! values. 

Input A-? 

X = Low hex byte to print 
Y = High hex byie to prim 

Ouipui Unchanged = X/Y/'DBK/K/D/e 
Scrambled = A/U/P 



Sr^l PRNTAX 



Print contents of A and X registers in hcs formiL 



PRNTYX prints the content of the A and X rasters as four-digit 

hexadecimal values. 

Input A - High hex byte to print 

X = Low heK byte to print 
Y-? 

Output L'nchangcd - X/Y/DBB/K/D/c 
Scrambled = AJB/? 
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PRNTX 



Print contents of X regisxer in hex fonnat. 



PRNTYX prints the tontcnt* of ihe X register as a two-digit hexadecimal 

value. 



Input 




A = ? 

X « ilex byte to prinl 

Y 

Unchanged - X/Y/DBR/K/D/e 
Scrambled = A/B/P 



Print 3 spaces. 
PRBLNK outputs 3 blank spaces to the standard output device. 

Input A = ? 

X- ? 

Y 

Unchanged - Y/DBR/K/D/e 
Scraunbled = B/P 
Special = X = SOO 

A « SAO Cspace ASCn code) 

Print X number of blank spaces. 

PRBL2 outputs from 1 to 256 blanks to the stsjidard output device. 

A - ? 

X » Number of blanks lo print (SOO « 256 blauiks] 

Y-? 

Unchanged - Y/DBE/K/D/c 
Scrambled - B/P 
Special ^ X = $00 

A - 3A0 (space ASCU code) 
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SFP53 PCADJ 



Adjust Monitor program counter. 



PCADj increments the program counter by 1, 2, 3, or A, dtjpGnding on the 
LENGTH (address S2V) byre, - add 1 byte, 1 = add 2 bytes, 2 - add 3 bytes, 
3 = add 4 bytes. 

Note: FCyPCH (addresses S3A/S3B) are not changed by this caU, The 
AA' registers contained ihe new program counier at the end of this caU, 

Input A > ? 
x = ? 

Y"? 

PCL ^ (Address 53A) program counier low byte 

PCH = (Address S3B) program counter high byte 

LENG11I - CAddress $2F> lenglii 1 to add to program counter 

Output Unchanged - DBR/K/D/e 

Scrambled = X/E/P 
Specia] ■ A " New PCL 

Y = New PCH 

FCL/PCH not changed 

5F962 TEXT2COPY Enable or Disable next Page 2 software-shadowing. 

TDHIGOFY iDggIgs [hg im Pag? Z softwire-shadowing function on and 

o!f. The first access to TEXTSCOPY enables shadowing, and die newt access 
disables shadowing ^Tien TEXT2COPY is enabled, a heartbeaL task is 
enabled thai, on every VBL, copies the information from bank SOO 
locabons $O400-SO7FF lo bank $B0 locations &04QO-S07fT. It then enables 
VBL interrupts. VBL inlierrupts remain on until Control-Resei 'm pressed oc 
until the system is restarted. TEXT2COPV can disable the copy funaion, 
but canntji disable VBL inteirupl£ once they are enabled. 

Enpuc A = ? 

X = ? 
Y-? 

Output Unchanged = DBR/K/D/e 
Scrambled - A/X/Y/B/P 
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$FA40 OLDIRQ 



Go lo emulation-mode imemjpi-handling rcsuUnes. 



Jumps lo the iniermpi-bandling rouiines that handle: emulation-mode BRKs 
and IRQs. AJl registers arc restored after the application performs an RTT at 
the end of its installed Lntemipt routines, l-ocation SA^ is noi dcslniycd as in 
the Apple II, Apple II Plus, and original Apple He computers. 

Input A " ? 

Output Unchanged - A/X/Y/DBR/P/B/K/D/e 
Scrambled = Nothing 



SFA4C BREAK 



Old 6502 break handler 



BREAK save* lite 6502 rdgisiters and ihc progiam counter and then jumps 
indlrecEiy through the user hooks ai $03fO/iO3Fl Noie thai thii; call aOecifi 
ihe 6502 registers, ntS the 65C616 registers. This entry point is obsolete 
except in very rare circumstances. 

Input A = Assumes A was stored at addiess $45 

X= ? 
Y-? 

Output Unchanged = DBR/K/D/e 

Special = A511 (address $^15) ^ A value 
XREG (address S46) = X value 
YREG (address $47} = ¥ value 
STATUS (address U8) ^ P value 
SPNT (address $49) = S slack 
Pointer value 






$FA59 OLDBRK 



New 65C816 break handler. 



OLDBRK prio)s the address of the BBK instruaion, disassembles the BRK 
instruction, and prinis the content.? of the 65CS16 regisiefs and memofy 
configuration at the time the BRK instruction was executed. 

Input All 65Cai6 registers and memory conllguralLon saved by 

interrupt handJer 

Output Returns lo Monitor after displaying information 



Appendix C: Firmware Entry Points In Bank SOO 



233 



1 



$FA62 RESET 



Hardware resei handler. 



BESET se:s up all necessary wafm-siart parameiers for Uie Apple IIGS. It is 
caUed by the 65C816 resel veclor slored in ROM in locations SFFFC/SFFFD. 
If normal warm siart occurs, it ihen exits through user VTiclors at 
$D3F2/503r5- If cold start occurs^ it then exits by attempiing to siart a startup 
device such as a disk drive or Applelalk, depending on Control Panel 
sellings, If 3 program JMPs hcic, it mujf enter in emulation mode with [he 
direct-page register set to SOOOQ, Lhe data bank register set to $QQ\ and the 
progrsm bank registef set to $00, or RESET wiil not work. 

Input K/DBR/D/e = 300 

Output Doesn't return to calling progiam 



SFAA6 PWRUP 



Sy$teiTL cold-start routine. 



PWRUP performs a partial system reset and then attempts to statt the system 

via a disk drive or AppleTalk. PWRUP also zeros out xnemory in bank 00 
frorn address 5osO0-SBrTF. If a program JMPs here, it miwC enter in 
emulation mode, with the direct-page register set iti SOOQO, the data bank 
register set to SOO, and the progiann bank register set to $00, or RESET will 
no: work. If no startup device is available, the message Ctieck startup 
Device appears on the screen. 



Input 



K/DBR/D/e = $00 



Output Doesn't return to calling program 



Sfaba sloop 



Disk controller slot search loop. 



SLOOP is the disk controller search loop. It searches for a disk controller 
beginning at the peripheral ROM sp3.ce (if RAM disk, ROM dUik, or 
AppleTalk has not been selected via the Control Panel as the startup 
device) pointed to by LOCO and LOCI (addresses SOO/SOl). Tf i- startup 
device is found, it JMPs to that card's ROM space. If no startup device is 
found, the message Check Startup Device appears on tlie screen. If 
RAM disk or ROM di^k has |)een selected, then ihe firmware JMPs ta the 
SmartPort code that handles those startup devices. If slot 7 was selected and 
AppleTalk is enabled in port 7, the firmware JMPs to the AppleTalk boot 
code in slot 7. 

Input A - 7 

X = ? 

Y *" ? 

LOCO - (Address 500)'; must be $Q0, or startup will not occur 
LOCI = (Address SOI); contairw $Cn, where n = next slot 
number to test for a startup device 

Output Doesn't return to calling program 
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JFAD7 


1 

REGDSP Display coriienis df rcgi^tCiS, 

KEGDSF displays sll 65CSl6 register conients stored by the Hmiware and 
Apple ncs memqry-scsie informaiion, induding shadowing and system 
speed. Displayed values include Ayx/Y/K/DBR/S/D,'T/M/QymA/e/L, 
AmOOT/S are always saved and displayed as l6-bit values, even if emulation 
mddi: gj" 8'bil nalive mode is selected. 

Input A - ? 

Y ^ > 

Output [Unchanged ^ DBE/K/D/e 
Scrambled ^ A>'X/Y/B/F 


1 


iFB19 


BTBL Register nan*es table for 6502 register? only. 

• 

This ts not a callable rouline. It is a fixed ASCII string. The fixed suing is 
'AXypS', Some rouUnes require this siring here, or ihey will not execute 
properly. The most significant bit pf each ASCU character is set to 1. i 

Input No input (not a callable routine) i 

Output No cHJtput Cnot a callable routine) 




SFBlE 


FREAD Bead a hand controller, 

PREAI> returns a number that represents the position of the specified hand 
controller 

Input A = ? 

X - 0, 1, 2^ or 3 only " Paddle to read 

Y = ? i 

Output Unchanged = X/DBR/K/D/e j 
Scrambled - A/B/P 
Special =^ Y ^ Paddle count 




SFD21 

1 


PIIEAD4 Check timeout paddle; then read the h^Jid controller. 

PREAD4 verifies that Ehe paddle (hand controller) is in timeout mode and 
ih^n reads the paddle the same as PJt£AD docs, returning a number thai 
rcpfcsenLs the position of the specified hand controller. 

Input A = ? 

X = 0, 1, 2, or 3 only = Paddle to read 
¥ =? 

Output Unchanged - X/DBR/K/D/e ! 

Scrambled - A/B/P 
Special = Y ■ Paddle count 
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SFB2F I S IT Initialiae text scieea 

INTT sets up ^e screen for fuU window display ancl lexi Page 1. 
Input 



Output 



SFB39 SETTXT 



A = ? 

Y-? 

Unchanged - DBR/K/D/e 
Scrambled » X/V/B/P 
SpedaJ = A = BASL 

Sel lexl mode. 



SETTXT sets saeen for full texL window, but docs not TortE leKt Page 1. 



To put 



Output 



SrB40 SETGR 



A - ? 
X= ? 
Y = ? 

L'nchanged - DQR/KyD/e 
Scrambled - X/Y/B/P 
Special - A = BASL 

Set graphics made_ 



SETGR se« screen for mixed graphics mode and dears the graphics portion 
of [he screen. It dien sees ihe top of iJie window to line 20 for four lines of text 
Space below the graphics screen. 



Input 



Output 



3FB4B SETWND 



A = ? 
X- ? 
Y = ? 

Unchanged - DBR/K/D/e 
Scrambled - X/Y/B/P 
Special - A = BASL 

Set lexi uindow size. 
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SEt"WND seta window lo Lhe following: 

WNDLrr (address = $20) = SOO 

WNUWDTH (address = 521) = $2B/$50 (40/80 columns} 

WND'IOP (address 522) - A on enLiy 

WNDBTM (address $23) = SIS 

Input A - New WMDTOP 

X - ? 
Y-? 

Output Unchanged - X/DBR/K/D/e 

Scrambk-d = Y/D/P 
Special = A = BASL 
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I /; -uctL-sc". 1? 



JFB5 1 SETWND2 Set text window width and botlam &13b 

SETVirN'D2 sets window lo the following: 

WNDWDTll (address « 521) - S28/$50 (40/80 CDlumns) 
WNDBTM (address S233 = 113 

laput A = ? 

X= ? 
Y-? 

Output Unchanged = X/DBR/K/D/e 
Scrambled = Y/B/P 
Special - A - BASL 



SFB5B TABV 



Vertical lab. 



TARV siores ihe value in A in CV (address $25) and then calculates a new 
base addiess for storing data to the screen- 
Input A = New vertical position (line numbaf) 
X- ? 

Oufput Unchanged - X/DBR/K/D/e 
Scrambled = Y^B/P 
Speaal = A ^ BASL 

$FB60 APPLEII Clears screen and displays Apple IIGS logo. 

APPLEII dears the screen and displays [he startup ASCII string 'Apple IlGS' 
on the first line of the scfeen 

Input A ■ ? 

_Y-? 

Output Unchanged - X/DBF/K/D/e 

Scrambled - A/Y/B/P 

SFB6F &ETPWRC Create power-up b>^- 

SETPWRC calciiiates the "funny" complement of the high byte of the RESET 
vector and stores it at PWREDUP (address S03F4). 

Input A - ? 

X = ? 

Y = ? 

Output Unchanged = X/Y/DBR/K/D/e 
Scrambled = B/P 

Special = A = PWHEDUP 
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5Fn78 VIDWAIT Check Tor a pause (Conirol-S) request. 

VIDWAIT ttiecks the keyboard for a Control-S if it L5 called with an $3D 
(carriage return) in the accumulator. If a Conirol-S is found, [he system falls 
:hrough [o KBDWAET. If ii is noi. control i.s $erti to VIDOLT wtiere the 
character is printed and the cursor advanced.^ 

Input A = Output character 

X = ? 

y = ? 

Output Unchanged = X/DBR/K/D/e 

Scrambled = A/Y/B/P 

JPUaS KBDWAIT Wait lor a keypress. 

KBDWAIT waits for 3 keypress. The keyboard is cleared ^unless the keypi^s 
is a Conlfol-C), and then control is sent to VIDOUT, where the character is 
printed and the cursor advanced. 

iQpm A - ? 

x = ? 

Y- ? 

Output Unchanged = X/PBR/K/U/e 
Scrambled - A/Y/B/P 

SFBB3 VERSION One of the monitor ROM's main identification bytes 

This is not a callable ronjtine. It is a fixed hex value The fixed value is S06_ 
Tim is ihti idGniificaUon byte diat indicates wheU^er this is an Appte He or a 
later system. This byte is the same in the Apple lie, the enhanced Apple He, 
the Apple lie. the enhanced Apple lie, and ihe Apple IIGS. 

Input No input (not 3 caJlabIc routine) 

Output No output (not a callable routine) 

SfBBF ZIDBYTE2 One of the monitor ROM's main idenlificalion bytes. 

This is nQ[ a callable routine. It iis a fixed hex value.. The futed value is SOO. 
This is the identification byte that indicates this is an enhanced Apple lie or 

a later sysiem. 

Input No input (not a callable routine) 

Output No ojtput (not a callable routine) 



238 



Appendix C: Rfmware Entry Points In Bank SCsO 



SFBCO ZIDBYTE One of the Monitor ROM's main identincation bytes. 

This is not a callable routine. U i^ a fixed hex value. The Exed value is SH). 
This is the ideniificauon byte that indicaies this is an enhanced Apple He or 
t later system. 



Input 

Output 

SFBCl BASCALC 



No ijipuL (noi a callable routine) 
No ouLpui Cnoi i callable roulire) 

Text baW'addiess calcuUtoi. 



BASCALC calcubies the baae address of the line for the nex[ lexi character 
on the 40-column screen. The values calculaLed are stored at BASLVBASH 

(addmsscs $0028/50029)- 



Input 



Output 



$FBDE> BELLI 



A = Line number Id calculaie base for 

X-? 

Y = ? 

Unchanged - KA-ZDER/K/D/e 
Scrambled - B/P 

special = A = BASL 

Generate user-selected bell tone. 



BELLI generates the user-selected Cvia the Control PaneD bell cone. There 
is a delay prior to the tone beinj; generated lo prevent rapid calls to BELLI 
from causing disiorted bell sounds. 



Input 



Output 



SFBEZ BELLI. 2 



A. -? 
X = ? 
Y -? 

Unchanged = X/DBR/K/D/c 
Scfarnbled = A/B/P 
Special - Y - 3O0 

Generate user-selected bel! lone. 



BELLI. 2 generates the user-selected (via the Conirol Panel) bell tone. 
There is a delay prior to ilic tone being generated to prevent rapid calls to 
BELLI. 2 from causing distorted bell sounds. 

Input A - ? 

X = ? 
Y = ? 

Output Unchanged = X^DBH/K/D/e 
Scrambled = A/B/P 
Sped it = Y= SOO 
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iFBlH 



BELL 2 



Generale user-selected bell tone. 



BELL2 generates the user-selected Cvia the Conirol Panel) bell lone. There 
is a delay prior \Q ths lane iKfing gdndraied to prevent rapid CiWs to BELL2 
from causing distorEed bell sounds. 

Input A =" ? 

X= ? 
Y = ? 

Output Unchanged = X/DDR/K/I>/e 
Scrambled = A;'B/P 
Spedal = Y = 



$FBFO STORADV Place a printable character on the screen, 

STORADV stores the value in the accumulator ai the neil posi Jon in the lext 
buffer (screen Itjtaiigm) and sdivances to the next screen location position. 

Input A = Charaacr lo display in line 

X " ? 
Y = ? 

Output Unchanged = X/DBR/K/D/c 
Scrambled - A/Y/B/P 



SFBF4 ADVANCE [ncrcment the cursor position. 

ADVANCE advances the cu/sor by one position. If the cursor 13 at the 
window limit, this call issues a carriage return to go to the next Lne on the 
screen, 



Input 



Output 



SFBFD VXD OUT 



; 



A =? 
X - ? 

Y-? 

Unchanged - X/DBR/K/D/e 
Scrambled = ^VY/B/P 

Place % character on the screen, 



II 



VIDOUT sends printable characters to .5TORADV. Rewm, line feedi 
forward, reverse space, and so on are sent to the vector of appropriate 
special routines. 

Input A = Character to output 

X- ? 

Y = ? 

Output Unchanged - VDBRyK/D/e 
Scrambled - Y/B/P 
Spedal = A = Output character 
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SFCIO BS 



Backspace, 

BS decremenis thd cuisor one position. If the cursor is at the bcgirming of 
the window, the horizontal cursor position is set to the right edge of the 
window, and. ihe foutine goes to the UP .Hibrouiine. 

Enput A = F 

X= ? 

y -> 

Output Unchanged - X/DBRyK/D/e 
Scramb]ed = A/Y/B/P 



SFriA UP 



Move up a line- 



up decremerns the cuispi' vertical locaUnn by nne line unlc^ss the tursor is 
cuffentiy on the first line. 



Input 



Output 



$FC22 VTAB 



A- ? 

X= ? 

Y = > 

Unchanged = X/Y/DBR/K/D/e 
Scratubletl = A/B/P 

Vertical lab. 



VTAB loads the value at CV Caddress $255 into the accumulator and goes to 
VTABZ. 



Input 



Output 



SFC24 VTABZ 



A= ? 
X- ? 

Y = ? 

Unchanged - X/Y/DBR/X/D/e 
Scrambled = B/P 
Special -^ A = BASL 

BASU'QASH (addresses S28/S29) - New base addi^ss 

Vertical tab (alternate entry). 



VTABZ^ uses the value in the accumulator to update the base address used For 
storing values in ihe tesa screen buffer. 

Input A - Line to calculate base address for 

X = ? 
Y"? 

Output Unchanged - X/Y/DBR./K/D/e 
Scrambled - B/P 
Special - A = BASL 

BASL/BASH (addresses 528/^5293 = New base addiess 
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SFC4Z CLREOP Clear to end of page. 

CLREOP dears the text window from the cursor position to the bodom of the 

Input A - ? 

X= ? 
Y-? 

Output Llnchanged - X/DBR/K/D/e 
Scrambled = AA'/B/P 

SFC5S HOME Home Cursor and dear to end of page, 

HOME mo^'es ihe cursor to ihe lop of screen column and ihen dears from 
there lo the bottom of the sareen window. 

Input A = ? 

X - ? 

Y = ? 

Output Unchanged = X/DBR/K/D/e 
Scrambled - A/Y/B/P 

$FC62 CR Begin a new line. 

CR sets Lhe cursor horizontil position at the left edge of the window and then 
goes to LF to move to the nexl line on lhe screen. 

Irtput A = ? 

X - ? 

Y = ? 

Output Unchanged = X/DBR/K/D/e 
Scrambled ^ A/Y/B/P 

SFC66 LP Line feed. 

LF inoemenis the vertical position of the cursor, If the cursor vertical 
position is no[ past the bouom line, the base address is updated; otherwise, 
Lhe routine jjoes lo SCROLL to scroll the screen. 

Input A - ? 

Y-? 

Output Unchanged -* X/DBR/K/D/e 

Scrambled = A/Y/B/P 
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SFC70 SCROLL 



Scroll the screen up nne line. 

SCROLL moves all characters up one line wiihin the current text window. 
"Hie cutsoi" postion is maintained. 

Input A = ? 

X- ? 
Y = ? 

Output Unchanged = X/DhR/K/D/c 
Scrambled - A/Y/B/P 



$FC9C CLREOL 



Clear to end of line. 



CLREOL dears a text line from [he cureor position to the right edge of the 
window, 



Input 



Output 



A - ? 

X- ? 

Y = ? 

Unchanged = X/DBR/K/D/e 
Scrambled - A/Y/B/P 



JFC^E CLREOLZ Ocar to qnd of line. 

CLREOLZ deare from Y on the current line to the right edge of ihe text 
window. 



Iriput 



Output 



A ° ? 
X= ? 



Y " Horiionial position to start dearing from 

llnthartgcd - X/DBK/K/D/e 

Scrambled = AA'/B/P 



SFCA8 WAIT 



Detay loop (syslem-speed indcpcndentX 



WATT delays for a spjecific amount of time and then retum* lo tlit! program 
that called it, 'ITie length of the delay is specified by the eontenls of the 
acajmulatuir. With A the contents of the accumulator, the delay is 
1/2C26+27A+5A^2)'1V]4,51818 microseconds. WAIT should be used as a 
mmimium delay lime, nol as [he absolute delay time. 

Input A ■ ? 

X- ? 

Y = ? 

Output Unchanged = X/Y/DBR/K/D/e 
Scrambled - B/P 
Spedai - A - SOO 
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SFCB4 NXTA4 rncrement pointer at AAL/AAH (addre^es $42/$43). 

NXrA4 increments the iS-bit pointer at A4L/A^1H and ihen goes to NXTAl, 

Input A = ? 

X = ? 
Y-? 

Output Unchanged = X/Y/DBR/K/D/e 
Scrambled =■ A/B/1^ 



SFCBA NXTAl 



Compare AII^AIH (addresses S3C/S3D) with A2L/A2H 
(addresses %5E/$5tO and then increment AlUAlH. 



NXTAl pcffornis a l6-bil comparison of AIL/AIH with A21/A2H and 
increments the l6'bit pointer AIJVAIH. 

Input A = ? 
X •? 

Qutimt Unchanged - X/Y/DBR/K/D^ 
Scrambled = A/B/P 



iTCCP HEADR 



Write a header to cassette tape Cobsolece). 



HEADR is an obsolete entry point for [he Apple IIG5. It does nothing except 

perform an RT5 back to the calling routine. 



Input 

Output 
SFDOC RDKEV 



A - ? 
X = ? 

Unchanged = A/X/Y/P/B/DBR/K/D/e 

Get an input char&cier and display old inverse flashing 
cursor. 



II 



RDKEY is a character-input subroutine. It places ihe old Apple n Lnverse 
character flashing cursor on the display at the currenL cursor position and 
jumps to subroutine SFDID. 

Input A ^ ? 
x = ? 
Y-? 

Output Unchanged = X/DBE/KyD/e 
Scrambled - Y/B/F 
Special = A ■ Key pressed (entered character) 
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JFDIO FDlO 



Gel an input chaiacter and don'i display inverse flashing 
character cursor. 



FDlO is a characier-Enput subroutine. Tt jumps to the subrouiine whose 
address is scored in KSWL-'KSW'U (addresses S38/S39), iLsuaUy the standard 
input subrtjutine KEVIN, which displa^^ the narm.aJ cursor and returrLS wjth a 
character in the aconnuialcir. SFDIO returns only after a key has been 
pressed or an input character has been placed in the accumulator. 

Input A ^ ? 

X-? 
Y = ? 



Output 



SFD18 RDKEYl 



Unchanged - X/DBR/K/D/e 

Scrambled « Y/B/P 

SpeciaJ = A = Key pressed (entered characier) 

Get an input character. 



RDKEYl jumps to the subroutine whose address i5 stored in KSWL/KSWH 
(addresses S3S/339), usually the standard input subroutine KEYIN, which 
returns with a character in die accumulator. RDKEY] returns only after a key 
has been pressed or an input character hag been pilaced in the acoamulalor. 

Input A ° ? 

x = ? 

Y = ? 



Output 



5PD1B K£YIN 



Unchanged = xyDER/K/D/e 

Scrambled - Y/B/P 

SpcdaJ = A = Key pressed (entered character) 

Kead the keyboard. 



KEYIN is a keyboird-inpul subrouiine. Tt tests the Event Manager to see if it 
is active, If it is active, KEYIN reads the key pressed from the Event 
Manager; otherwise, it reads the Apple keyboard directly. In any case, i[ 
randomizes the random-number seed KNDL/RNDH (addresses f'lE/S4F), 
When a key is pressed, KEYIN removes the cursor from the display and 
returns with the keycode in the accumulator. 

Input A = Character below cursor 
X = ? 

Output Unchanged - X/DBK/K/D/e 
Scrambled = Y/B/P 
Special * A = Key pressed (entered character) 
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SFD3S RDCHAR 



Gei an input character and process escape codes. 

RDKEY IS a character-inpuL subroudne; ii also interprets the standard 

Apple escape sequences. It places an spprnpmte cursor on ihe display at 
tht cursor position and [umps to the subroLJitine whose addiess. as stored in 
KSWL/KSWH (addresses SW/SS?), usually the standard input subroutine 
KEYINj which rcinms wid^ a charaaer in ihq accumulaior. RDCHAH recunis 
only after a non-c escape-sequence key has been pressed or an input 
character has been placed in the accumulator. 

Input A = ? 

y = ? 

Output Unchanged = X/l>BR/K/I>/e 

Scrambled - Y/B/P 

Special = A = Key pressed (entered characier) 



iFD67 GETLNZ 



Get an inpuc line after issuing a carriage retym. 

GETLNZ is an alternate entry point for GETLN that sends a csrriage return to 
The Standard output and then continues in GETLN. The callinfi program 
must call GEfllN with ilie prompt character al PROMPT (address 533). 



Input 



Output 



5fd6a getlk 



A = ? 
x = ? 
Y-? 
PROMPT = (Address S333 = Prompi character 

Unchanged = DDR/K/D/e 
Scrambled - AyV/B/P 
Special = $200-t2xx contains input Line 
X - Length of input line 

Get an input line wi\h a prompL 



GETTLN in a. standard input subroutine for entire lines of characters. The 
calling program must call GETH^J with die prompt character al PROMPT 
(address $33). 



Input 



Output 



A = > 

Y-? 

PROMPT = (Address $33^ 



Prompt character 



Unchanged = DBR/K/D/e 
Saambled = A/Y/fl/P 

special - i200-j2xx contains input line 
X - Length of input line 
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SfhSc getlno 



Gel an input line wiLh a prompt (alternate entry), 



II 



GETLNQ outputs t±ie contents of the accumuJaior as the prompt, If Lhe user 
canoeSs the input line with Conlrol-X or by entering too many backspadtrs, 
the contents of PROMPT (addnss $35) wiJl be issued as the prompt when it 
gets another line. 



Input 



Output 



$FD6F GETLNl 



A " prompt character 

X - ? 

Y = ? 

PROMPT - (Address S33> = Prompt character 

Unchanged - DBR/K/D/e 
Scrambled = A/Y/D/P 
Special = $200-S2xi contaias input line 
X " length of input ljr>e 

Get an input line with no prompt Caltcmate entry). 



GETLNl is an aliemaLe ernry point for GE'IIM that do^ not issue a prompt 
before ii accepts the inptJt line. If the user cancel? the input line w-ith 
Control-X or by entering too many backspaces, the conicnm of PROMPT 
(address $33) will be issued as the ptqmp\ when it gets another line, 

Input A = ? 

X-7 
Y = ? 



Output 



$FD8J3 CROTJTl 



PROMPT - (Address i33> = Prompt character 

Unchanged = DBR/KyD/e 
Scrambled - AA'/B/P 
Special = S2Q0-i2Kx contains input line 
X ■ Length oF input line 

Clear to end on line, then Issue a carriage return. 



■ 



CROUTl deara. the current line from the current cursor position to the right 
edge of the text window. It [hen goes to CROUT to isjjue a carriage return, 



Input 



Output 



A - ? 
X = ? 
Y = ? 

Unchanged = X/DBR/K/D/e 

Scrambled = Y/B/P 

Spedal ■ A ■ SSD (carriage return) 
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SfDHE CKOIT 



Issue a carriage reium. 

CROUT issues a carriage return lo ihe output device pointed to by 

CSWL/CSWH (addresses $56/537), 

Input A ■ ? 

X= ? 
Y = ? 



Output 



$FD92 PRAl 



Lnchanged - X/Y/DBR/KyD/e 

Scrambled = B/P 

SpcciiJ = A » tSD Ccarriagc rciurn) 

Prijii a carriage return and AIL/AIH (addresses $KV$3D) 

PRAl sends 3 carriage rciurn character CiSD) to ihe curiEni autpjt device, 
fotlowed by ihc contenls of Ihe l6-bil pointer All/AlH (addresses 

($3C/S3D} in hex, followed by a colofi (:), 

Input A = ? 

Y = ? 

Output Unchanged- DBR/K/D/e 
Scrsmbled = X/y/P 
special "A - SBA Ccolon) 

Y=S0O 



3FDDA PRBYTE 



Print a hexadecimal byte. 



PRBYTE outputs the contenls of the accumutator in hexadecimal Formal lo 
die curn^nL LiuLpuL device. 

laput A - I iex byte to prinE 

X- ? 
Y = ? 

Oulput Unchanged = X/Y/DBK/K/D/e 
Scrambled = A/B/P 



SFDE5 PRHEX 



Print a hexadecimal dtgiL 



PRHEX Outputs the lower nibble of the accumulator as a single hexadecimal 
digil Lo Ihe current outpul device. 

Input A = Lower rut±:le is digil Lo output 

X » ? 
Y=? 

Output Unchanged - X/Y/DBR/K/D/e 
Scfambled - A/B/P 
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$FDED COOT' 



Output a character. 



COUT calls the curfem output subroutine. The character to output should be 
in ihe accumulalor. COUT calls the subroutine whose address 15 stored in 
CSWL/CSWH (addresses i36/$37), which is usually the standard cUraclcr- 
oulpui routine COUTl. 



Input 



Output 



JFDFO COUTl 



A = Character to print 
X - ? 
V- ? 

Unchanged = A/X/vyDBR/KyO/e 
Scrambled - B/F 



Output a character to the screen. 

COLTTl displays the character in the accumulator on the Apple screen at the 
cunrem output cursor position and advanoes [he output cursor. It places the 
character using, the settings of the normal/inverse location TNVFI.G (address 
532). It handles ihc control characters for return (58DX line feed CS8C?, 
Backspace/Left Anow CSS8}, Right Arrow CS95), and bell ($87) and the 
Change Curisof command CControl-'^ - $9E) 

Input A = Characifir to prim 
X-? 
Y = ? 

Output Unchanged = A/X/Y/DBK/K/D/e 
Scrambled = B/P 



*fdf6 coutz 



Output 3 chaiactcr to the screen without masking it with the 
inverse Hag, 

CQLiTZ outputs the character in the accumulator without masking it with the 
inverse flag INVFLG (address S32) Output goes to the screen. 

Input A = Character to print 

X= ? 
Y =? 

Output Unchanged = A/XA'/DBR/K/D/e 

Scrambled = B/P 
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li 



.$FE1F TOROUTIfJE RcLuriu idenlirication informationi about the system. 

IDROUTTNE Is called with c (carry) set. If it returns wilh c (carry) dear, then 

the system Is an Apple IIGS or a later sysiem, and the registers jVX/Y 
coniain ide nLiTication informaiion aboui die system. 

Input A = ? 

X= ? 

Y-? 

Output Unchanged - BURJK/D/g 
ScrambJed = B/P 
Special " c (carry) - if Apple IIGS or later. Tf c = 0, ihcn A/X/Y 

contain idertification information. Jf c - 1. Lhen 

A/X/y are unchanged. 



SFF2C MOVE 



Original Monitor Move rouiine. 

M0\T copies the conienL*; of memory From one range of locations to 

another. Thi^ subroutine is tio/ the same as the Monitor Move CM) 
■command. The destination addrcit:* mu.st be in ML/A4II (addresses 
$41/$A5X the siardng source address in AIL/MH (addressed S30S3D5, 
and the ending source address in A2L/AZH (addresses $5E/S5f) when 
MOVE is caUed. Y mu.-it eontain the starting oiFsel inio ihe 
source/destinalion buffers, 



Input 



Output 



A = ? 
X -? 

Y = Starting ofTset Into source/destination buffers Ci^ormally 

AIU/AIH = (Addresses S3C;&3D) - Start of source buffer 
A2L/A2U = tAddresses $3E/53F) - End of source buffer 
A4UA4H ' (Addresses $42/H3) = Start of destination 

buffer 

Unchanged = X/Y/DBR/K/D/e 

Scrambled = .VB/P 

Specia! » AllVAlH = (Addressers $3C/S3D) = End of source 

buffer + 1 

A2iyA2H = (Addresses S3E/S3F> = End of source 

bufTer 

A'lL/A'lH = (Addresses S42/$45> = End of destination 

buffer + 1 



SPE5E "LIST" 



Old list ■entry point inoi supported under Apple tlOS). 
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SETINV 


Set inverse text modt. 


1 


SETINV sets l^fVRG (address S32) so that subsequent text output to the 
scretin will appear in inveise mode. 


I 


Input 


A =? 

X -? 


1 


Output 


Unchanged - A.TC/DBR/K/D/e . j 

Scrambled = Y/D/P ! | 

Special - INMIG (address S323 - i3F 1 

Y-S3F '1 


^B $F£S4 


SETNORM 


Set normal text mode. ' 


■ 


Stl NORM sets INVFlXi (address J 32) so that subsequent text output to the ^ 
screen will appear" in normal mode. I 


1 


Input 


A = > 1 

X - ? : 

Y = ? '' 

.H 


1 


Output 


Unchmged = A/XTDBR/K/D/e |" 

Scrambled = Y/B/P '•- 

Special = INVFLG (address $52} - $FF ' 

Y = SFF ( 

i 




SETKBD 


Reset input to keyboard. | 


■ 


SETKBD resGL^ iripul hooks KSWL/KSWII (addresses t3S/$39) to point to 
the keyboard. 


1 


Input 


A - ? 

X-? , 

Y = ? ' 

il 


1 


Output 


Unchanged = DBR/K/D/e i 
Scrambled - K^XJV/B/? ij 


H SFH3B 


INPORT 


Reset input to a slot 1 


1 


LNPORT relets input hooks KSWiyKSWIl (addresses S38/S3m to point to the ' 
ROM space reserAi-ed for a periphcra.1 card (tn pori) in ihe slol (or port} 
designated by the value in the accumulator. 


1 


Input 


A ■ Slot number to set hooks to 

x = ? 

Y-? 


1 




% 


Output 


Unchanged - DBR/K/D/e 
Scrambled - A/X/Y/B/P 
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iPE33 SETVID 



Resei output to screen. 

SETVro reseis output hooks CSWl/CSWH (addies^s $36/5373 to ibe soeen 
display routines. 



loput 



A= ? 



Output Unchanged = DBR/K/D/e 
Scrambled - A/X/Y/B/P 



3FE95 OITTPORT 



Reset output Id a slot 

OLlTPORT reseis oulpul hooks CSVCVCSWH (addresses S36/S37> to point to 
the ROM space reserved for a peripheral card Cor pen) In the sIpI Cor port) 
designaied by ihe vaEue in the accumulaior. 

Input A = Slot number 10 n&5tS hqoks 10 

Y-? 

Output Unchanged ■ DBR/K/D/e 
Scrambled - A/X/Y/B/P 



5FEBi5 GO 



Original Apple II Go entry point. 



GO begins CKecutinn of the codte poinifid to by A1L''A2L (addresses 
$5C/$3D). 

Input A = ? 

X = SOI (required) 

Y-? 

AIL/AIH (addresses $3C/$5D5 = Stan address of program to 

run 
A5H (address 345) - A value to set up before running program 
XREQ (address $46} = X value co set up before running program 
YREG (address SAT) = Y \'aluc to set up before running program 
STATUS (address S48) =^ P status to set up before running 

program 

Output Unchanged - DBR/K/D/e 
Scrambled - A/X/Y/B/P 
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$FECD 



$FEFD 



SFF2D 



iFF3A 





1 


WRITE 


Write a record lo cassette tape Cobsolete). fl 


VCTU 1 b la an obsolete emiy point under Apple MCS. ll does noihinfi except ■ 
perfGrm an R're back lo the caMing routine. l| 


Input 


A-? 
X = ? 
Y-? 


Output 


Unchanged = A/X/Y/P/BDBR/K/D/e 


READ 


Read data from 3. cassette tape (obsolete]). 


BEAD is an obsolete entry point under Appie IICS. [i does nothing except fl 
pefform an R'l^ back lo the calling routine, 1 


Input 


A = ? 
X-? 
Y = ? 


Output 


Unchanged - A/X/Y/P/B/DBR/K/D/e 1 


PRERR 


Print ERR on output device. 1 


PRERH sends ERR to the output device and goes to BELL. fl 


Input 


A = ? 
X - ? 
Y = ? 


Output 


Unchanged = X/Y/DBR/K/D/e ^ 
Scrambled - B/P ' 
Special = A = SS7 (bell character) 


BELL 


Send a bell character lo the output device. 


BELL write* a bell (Control-G) character lo the current output device, 1 


Input 


A = ? ' 
x = ? 

Y - ? 


Output 


Unchanged = X/Y/DBR/K/D/e 

Scrambled = B/P 

Special = A = SS7 (bell character) 
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$FF3F 



RESTORE Restore A/X/Y/P regis lers. 

Restore 6502 register informalion fram locations S45- 



lnput 



Oucput 



5ff^a save 



A = ? 

X"? 

Y= ? 

A5H (address $^5) = New value for A 

XREG (address $46) - New value for X 

YREG (address S47> • New value for Y 

STATUS (address $48) - New value for P 

Unchanged - DBR/K/D/e 

Scrambled = B 

Special = A = New value 

X ■ INew value 

Y = New value 

P = New value 

Save A/X/Y/P/S registers and clear decimal mode. 



SAVE saves 6502 register information in locations yi5-$A9 and clears 
decimal mode. 



Input 



Output 



SFF58 lORTS 



A = ? 
X- ? 
Y = ? 

Unchanged = Y/DBR/K/D/e 

Scrambled = A/X/B/P 

Special = A5H (address S45> = Value of A 
XRKG (address S46) = Value of X 
YREG (address S4T> - Value of Y 
STATUS (address S'iS) = Value of P 
SPNT (address S49) = Vatue of stack poinier 2 
Decimal mode is cleared. 

Known RTS instrucdon. 



lORTS is used by peripheral cards to determine which slot a c^rd is in, 'Ihis 
RTS is fixed and wii] never be changed. 

Input A = ? 

X = > 
Y-' 

Output Unchanged = A/XA'/DBR/K/D/e 
Scrambled ■= iNothing, 
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w 



SFP59 OLDRST 



SFF65 



SFF69 



SFF6C 



Old Moniior entry poinL 

OLDRST sets up ihe video display and keyboard as oucpnit and input devires. 
It sei5 hex mrxie, docs not beep, and enters the Monitor at MONZ2. U does 
ncjL return to calJer. All Monitor 65C836 register storage tocalions are reset 
to standard values. 



In^ut 



A - ? 
X= ? 

Y = ? 



Output Does not return to calmer 



MON 



Standard Monitor enuy point, with beep, 



MON cleara decimal mo(te. beeps bell^ and enlers the Monitor at MONZ. 

All Monitor 65Bl6 regisiei- storage Eotiajicns. are reset to standard values. 



A = ? 
X- ? 
Y-? 

Does not return To cailer 



Input 

Output 

MONZ Standard Monitor entry point CCal! -151). 

All Monitor 65816 register storage locations are resen to siandard values. 
MONZ displays the * prompt and sends coiiirol to the Monitor input 
pa rse r. 

Input A = ? 

X -? 

Y = ? 

Output Does not return to caller 

MOVZ2 Standa.rd Monitor entry point (alternate^, 

MONZ2 does noi diangc MonJtor 65816 register storage locations. MONZ2 
di^iplays the * prompt and sends conlral lo iJie Monitor input parser. 

Input A = ? 

X- ? 

Y = ? 

Output Does not return to caller 
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SFF70 MONK4 



SFFSA 



No prompt Monitor entry poinL 

MONZ4 does not change Monitor 658l6 regisler Storage locaiions. No 
prompi is displayed. Control is sent to the Monitor input paiscr, 

Input A = ? 
X = ^ 

v = ? 

Output Does not return to caller 

DIG Shift hes digil into A2I/A2H (addresses 53E/$3F). 

DIG shifts an ASCII represcntaiion oFa. hex digit in the accumulator into 
A2Lh'A2H (addressee SSE/SSO and Lhe exiL^ into NXTCHR. 

Input 



Output 



$FFA7 GETIVIIM 



A = ASCII character EQRed with 
X- ? 

Y = Enliy point in input buETer $2xx at which to continue 
decocUng charaacrs 

Unchanged = DBR/Ky''D/e 

Scrambled - A/B/P/X 

Special ■ Y = Points to nc?^ character in input buffer ai S2xx 

Transfer hex input into A21/A2H Caddiesses $3E/S3F). 



GETMTJM scans the input buffer (S2xjt> starting at position Y. It shifts hiex 
digits into A2LyA2H (addresses S3B/35R until it encounters a nonheK digit. 
It then exits into NXTCHR. 

Tnput A - ? 

X = ? 

Y = Entry point in input butTer &2xx at which lo sLarl decoding 
characters 

Output Unchanged = DBR/K/D/c 
Scrambled • A/B/P/X 
SpeciaJ = Y = Points lo next character in input butTcr at $2xx 
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II 



SFFAD NXTCHR 



TransSate nexi character. 



NXTCI-IR is the loop used by GETNTJM to parse each character in the inpui 
buffer and convert it lo a value in A2L/A2H (address S3E45F). H also 
upshifts any [owercase ASCII values ihai appear in the input buffer [addresses 

$230t). 



Input 



Output 



SS^FBE TOSUB 



A" ? 

X = ? 

Y - EnLy poM in Jnpui bulTer 52xx at which to Start decoding 
characters 

Unchanged ■=■ DBR/K/D/e 

Scrambled ^ A/B/P/X 

Special - Y - Points to next character in inpoii buffer at 52xx 

Transfer control to a Monitor function. 



TOSUB pushes an excoilion address onto the stack and then performs an 

RTS to the roLiline. K is of very limiled use lo any program. 

Input A = ? 

X- ? 

Y - Offset Into subroutine table 

Output Unchanged = DBR/K/D/e 
Scrambled - .VB/P/X/Y 

JFFC7 ZMODE Zero out Monitor's mode byte MONMODE Caddress 331). 

ZMODE zeroes out MONMODE (address S3U. 
Input A - ? 

Y-7 

Output Unchanged « A/X/DBH/K/D/e 
Scrambled = P/B 
Special - Y - $00 
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Appendix D 



Vectors 



This appcndut ILsLs Lhe Apple llGS vectors. A vector 15 usually eilher a 2-byte address in 
page SOO or (possibly) a 4-byte lump insLmciion in a difTerGnt bank of memory. 
Vctiors are used lo efisure a coiintion interface pomi between externally developed 
programs and system -resident routines. ELxtcrnaE sofiwary jumps dJrectly Of indlreciJy 
through ilicsc vectors instead of atiempiing lo lotale and jump direcUy to the foutines 
themselves. When s. new vcriiHjn of the system is released, iJic vccior conienis change, 
thereby mainuJmng system integrity. 

For i3//of lhe vectors defined in this chapter, liie rollowing definitions applyi 
D A represents lhe lower S biis of lhe acaimulaJor. 
D B rcprt:seni5 the upper 8 bits of the accumulator, 
C X and Y represent S-bit index regisiers. 

□ DUR represents the data bank rejjisler. 
D K repre&enL^i me program Danit register, 
D P represents the processor status register 
D S represents lhe processor stack register, 
D D represents the direct-page register, 

n e represents the emu I a Lion-mock bitr 

□ c represents the carry Ilag. 

n V represents tJie overHciw fla.g. 

□ ? represents a value thui is undefined. 



S5Q 



Bank $00 page 3 vectors 

S03F(J-SO3Fl BRKV 



3O3F2^S03F3 



S03F4 



S03F5-S03F6-i;3r7 



User DRK vector. 



$03FE^O3FF 



Address of subroutine that handlos EEK iniernjpis. NormaJly 
points Lo 01J5BKK Caddress SFAJ?) in Moniior ]^OM, 

SOFTEV User sofl-enUy vecLor for R£SET. 

Address of subrnuUne Lhai handles warm start fRESET 
pressed). Normally points to BASIC or operating sysLem. 



FWREDlJP 



EOR ofbigh byte of SOFTEV address. 



PWEEDUP = SOFTEV + 1 EORed with cansLinL 5A5. If 
PWREDUP docs not equal SOFTEV + 1 EOHed wlh constant 
SA5, system performs cold start. If PWREDUP equals 
SOFTEV + 1 EOHed with constant $A% system pirrfDrm-s warm 
starL 

AMPERV Applesoft & JMP vector, 

Address of subroutine that haridies Applesofi & (ampersand) 
connnandR. Mnrmaily points to JORTS Caddresa .SFASS) in 
Monitor, Address S03F5 contains a JMP C540 opcode. 



S03FS-S03F9-53FA USRADR 



User Control-Y and Applesoft. 
USR Function JMP vector. 



Address of subroutine that handles user Control-Y and 

Applesoft USR function commands. NormaJly points to MON 
Caddress SFF65) in Monitor; points to BASIG.SYSTEM warm- 
start address if ProDOS 8 is loaded. Address i03FS contains a 
jMP CS^C) opcode. 



S03F11-&O3FC-S3FD IVMI 



User NMl vector. 



Address of subroutine ihat operating systems or applicatioris 
Can change to gain access lo NMl intermpti. Normally points 
to OLDEST (address SFF59) in Monitor ROM or to operating 
system if one is loaded. Address 503FB contains a jMP C$4Q 
opcode, 

IRQLOC Lser IRQ vector 

Address of subroutine diat operating systems or applications 
can change [o jijain access to TRQ inierrupls. Normally points 
to MOW (address $FF65) m IMonitor ROM nr to operating 
system if one is loaded. 



Bank SOO page 3 vectors 
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Bonk $00 page C3 routines 



$C311 



AUXMOVE Move data blocks between main and 

auxiliary 4BK memory. 

AUXMOVE is used by the Apple He and Apple IJc to move 
data blocks between main and auxiLary memory, For 

compatibiliCy rcasyns, Apple IIGS also supporLs LhLs cniry 
point if [he BO-column firmware is enabled via the Contra] 
Panel, 



Input 



Output 



A = ? 
x = ? 

Y = ? 
C- 1 

c = 
AIL - 

AlH - 

A2L = 

A2H = 
A4L - 

A4H = 



« Move from main to auxiUiiy memory 
= Move from auxiliary to main memory 

(Address S3C); source starting address, 

low-order byte 

CAddrcss S3D>^ source starling address, 
high-order byte 

(Addies» i3K)i source ending addres^s, 
Jow-order byte 

(Address $3F); source ending address, 
high'order byte 

CAddrcss 542); deslir^ation starting 
addires.Sf low-order byte 

(Address $45); desLinaiiort Slarting 
address, high-order byte 



Unchanged = A/X/Y/DBR/K/D/e 

Changed » B/P 

Ali^AlH = (Addresses S3C/i3D)=l6-bii source 

ending address +] 
A2L/A2H ■= CAddrcsscs 33E.''*3!0-l6-b[t source 

ending address 
A4iyA4H = (Addresses ^42/$45>l6^hil original 

destination address + number of 

bytes moved + 1 
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$Z5^4 



XFER 



Transfer program control between main 
and auxiliary 4SK memory. 



XFER is used by the Apple lie and Apple He to transfer control 
between main and auxiliary memorv. For compatibility 
reasons, the Apple lIGS also supports this entry poini if the 
SO-column firmware is enabled via the Control Panel. XFER 
assumes ihn the progi^mmcr has saved the cun^ni stack 
pointer at SOIOO in auxiliary memory and the alternate stack 
pointer at SQ101 in auxiliary memory before eallm;^ XFER and 
restores ihem after regaining control. Failure to restore ihcse 
poi-Htcfs causes program errors and incorrect interrupt 
handling. 

Input A - ? 

x = ? 

Y- > 

c = 1 = Tramrer control from main to auJdllajy 

memory 
c - = Trinsfcr control from auKiliary to main 
memory 

V = 1 - Use page ?ero and 5Wdt in auxiliary 

memory 

V = = Use page zero and stack in main memory 
S03£D = Program sLaning address, low-order 

byLe 
S03EE -^ Program starting address, high-order 
byte 

Output Unchanged = A/X/Y/DBR/K/D/c 

Changed = B/P 






Elcirik $00 page C3 [oijtln>es 
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Sank SOO page Fx vectors 

$FFE4-$FFE5 NCOP 



SFFE6-$FFE7 



5FFES-SFFE5^ 



SFF1!A-$FFEB 



Sffee-sffef 



Native-mode COP vector. 



This is not a callable routine. U is a l6-bit value thai changes 
with each ROM rdeaje. Its vaJut is noi guaranioed No 
program should use this value, This vecior is pulled from 
the ROM and used whenever a. n&Uve-mode COP is executed 



NBREAK 



Native-mode BRK vector. 



I'his Is not a callable rojtine, I; is a ]6-bit value [hal changes 
with each ROM release. Ils value is not guaranteed. No 
program should use this value. This vector is pulled from the 
ROM and used whenever a native-mode BRK is executed 



NABORT 



NatJve-mode ABORT vector. 



This is not a callable rouiine. It is a l6-bil value that changes 
wiih eacli ROM release. Its value is not guaran[eed. Nd 
program should use this value. This vector is pulled from the 
ROM and used whenever a native-mode ABORT i^ executed 



NNMl 



Native-mode NMI vector. 



This Is not a callable routine. It is a 16-bit value that changes 
wili-i each ROM fclea.Se. lis value is not guaramtecd. No 
program should use this value. "I'his vector is pulled from the 
ROM and used whenever a nativc-mcKle NMI is cxccuied. 



MRQ 



Naiive-mode IRQ vector. 



This i.s not a callable- routine. It is a l6-bii value that changes 
wi[h each ROM release. lui value is not guaranli^d No 
program should use this value, Tliiis vector is pulled from the 
ROM and used whenever a nativc-mode IRQ is executed. 



II 
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SFFF4-SKtT5 



I $FFFB^$FPF9 



SFFFA-iFFFB 



$FFFC-SFFFD 



ECOP 



Emulation-mode COP vector. 



This 15 noL z callable routine. It bs a l6-bit value thai changes 
wiJ] cad-i ROM release, lis value is noLguaranceed, No 
program should use thL^ value. Thi.9 vector is pulled from the 
ROM and used whenever an cmulatlon-mL'jdq COP 15 
executed. 



EABORT 



Emulation-mode AI50RT vector. 



Tliis is ncjl a callable routine. It is a l6-bit value that changes 
wiLh each ROM relea.se, [ts value is not guaranceed. No 
program should use ihis value. 'Vtiis vector is pulled rrom the 
ROM and used whenever an emulaiion-mode f\liORT is 
executed. 



ENMI 



Emulation- mode NMI vecior. 



This is not a callable routine. It is a l6-bit value that change 
with each ROM reEea.^e. Its value is not guaranteed. No 
program should use this value. This vcetor is pulled from the 
ROM and used whenever an emulation-mode NMI is 
executed. 



EWE5ET 



RESET vector. 



This is not a callable routine. It is a l6-bii value that changes 

ij^'ith each ROM release, iLs value Is no! guaranteed No 
program should use this value. ThJa vector is pulled from the 
ROM and used whenever a RESET ifi executed 



SFFFE-IFFFF 



EfiRIURQ Emulation-mode BHK/3RQ vector. 

This is not a caJIable routine. It is a l6-bl[ value Lbat changes 
with each ROM release, lis value Is not guaranteed No 
program should use this value. This vector is pulled from the 
ROM and used whenever an emulation-mode BRK or IRQ Is 
executed. 



Bank £00 page Fx vectors 
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Bank $E1 vectors 

'Ihc vectors DISPATCfd iJirough SYSMGRV arc guaranieed to be in the given 
!uc3[«ons in Lhis and ailt futun: Apple llGS— compaiible machines. 



$El/0O0C^00O3 



JiKl/Q004-0007 



SE1/0008-OOOB 



$El/OOOC-flOOF 



DISPATCHI 



Jump lo tool locator eniry lypc 1. 



UncondiUona] jump lo lool loacor entry type 1. JSL from 
user's code directly to the [ool locator with this entry poinL 
The form of the call in memory is as fallows: 

JMP abslong CS5C/low byte/high bytenlsank byte) 



DISPATCH 2 



Jump lo tool locator cnlry type 2, 



Unconditional jump lo tool locator enliy type 2. J5L lo a JSL 
from user's code to tlic tool locaioi with this entry point The 
frjnri of the call in memory is as follows; 

JMP ab&lon^ Ci5C/low byte/high bylc/bank byte) 

UDISPATCHl Jump to toal locator entry type 1. 

Uncondiiitmal |ump to user-installed tool locator entry type 

1. JSL from user'5 code directly to ihe i^ser-inslalled tool 
locator with lhi$ entry point. The form of the call in memory 
is as follows: 

JMP abslong C$5C/]ow byte/high byte/bank byte) 

UDISPATCH2 Jump to tool locator entry type 2. 

UncondiLiofial jump to user- installed tool locator entry type 

2. JSL lo a JSL from user's code to the user-installed tool 
locator witlt nhis enLry pcinL. The form of ihe cail in memory 
is as follows: 

JMP abslong CS5C/low byie/high byte/bank byte) 



$EyooiD-aoi3 



INTMGRV 



Jump to aystem ini>srnjpt manager 



Unconditional jump to the main system interrupt manager. 
If the application patches out this veclor, the application 
must bo able lo handle all ifitcmjpt'i in [he same fashion 
as the built-in ROM interrupL manager. Olherwtse, the system 
will not, in most circumstances, run. The form of the call 
in memory is as follows; 

JMP abslong (S5C/lowr byte/high byte/bank byte) 
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SE1/O014-O017 



COPMGRV 



$E1/001S-001B 



jEi/ooic-ooir 



Jump lo COP manager. 



Uncondilional jump to COP (coprocessor) manager. 
Currently points lo code that causes ihe Monitor to print a 
COP insifuction disassembly, similar to the BRK 

disassembly. The form of the call in memory is as follows: 

JMP abslong (S5C/Efiw byte/high byte/bank byte) 



ABORTMGIt.V 



Jump ID aborL manager. 



Uncondiiionfil jump to aborl manager Currently points lo 
code that causes the Monitar to print die disassembly of the 

Lnstrtiction being executed, similar to Lhe BRK dLsassembly 
The form of Lhe call in memory is as follows; 

JMP absiong (55C/1dw byte/high byte/bank byte) 



SYSDMGRV 



Jump to system faiEurc manager. 



Unconditional Jump to the sysE^m failure manager, fliis 
call assumes lhe rollowing: 

Q Entry is in l6-bil native mode. 

a c Corry) =■ if user defined messaije is poimed to on stacks 

c - 1 if the defaulL value is used 
□ The stack is scE up as follows: 

9,S =■ Error high byte 
8,S = Error low byte 
7,S ^ Null byte of message address 
6,5 ■ Bank byte of message address 
5,S = High byte ttf message iddress 
^,S = Low byte of message address 
3,S = XJnu.sed return address 
2,S = Unused return address 
1,S ■ Unused return address 

The form of Ihe call in memory i^ as follows; 

JMP ab^tung CS5C/low byte/high byte/bank byte) 



Bonk SEl vectors 
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IRQ.APTALK and IRCi,$ERIAL vectors 

Vcclors IRQ.A?TALK and IRQ.5ER1AL are normally set up to poinl Id the Interrial 
intermpt handier of lo cotfc that sets carry and ihcn pcrfomis an KTI. back to the 
Interrupt manager. AH the routines ?re called in 8-bJi native mode and at high speed. 
The data bank register, the direct regisLer, WSLOT (S7F3), and the stack pointer arc 
noi preset or set as for other inteirupt vectors. The called routine must KlMia carry 
dear if the rouiine hanctled tJje InneTfupi and carry set if it did not handle the interrupt. 
Carry clear tells the inierfupt manager noi to call ihc applicatJon or operating sysiem. 
Carry Kl tells the interrupt manager that the applicalion or the opcfaling system must 
be natiPied o( ihe curreni interrupt. The called routines must preserve Lhe DBB, speed, 
S-bit native mode, D regL^ter, stadc poinier Cor jusE use currei^l stack), and MSLOT Ibr 
proper operation. A/X/Y need not be preserved. Intcmipls are disabled on eniry la 
alt inreiTupi handler*. The user's iniernjpl handler must not reenable interrupts from 
wiLhtn ihe handler. AppleTalk and the Desk Manager are allowable exceptions. These 
vectors should be accessed only via the MtscellaneDus Tool Set. Their location in 
memo[y is noi guaranteed. 



SEl/0020-0023 



SEl/0024-0027 



IRQ.APTALK Jump to AppleTalk interrupt handler. 

UnconditionaJ jump to the AppleTalk LAP Qink access 
protocoU interrupt handler. Handles SCC interrupts 
intended for ApplcTaJk. The form of the call in memory is 

as follows; 

JMP abslong CS5C/low hytc/high byie/bank byte) 



IRQ.SERIAL 



Jump to serial-pjon inierrupt handler. 



Unconditional jump to serial-port interrupt handler. 
Handles innerrupis intended for seriaS ports. The form of the 
cali in memojy is as follows: 

JMP abslong ($5C/low byte/high byte/bank byte) 



I 
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Append k D; Vectora 



ia^=s^^^ 



IRQ.SCAN through IRQ.OTHEff vectors 

Vectors IRQ.SCAN Ihrough IRQ.OTHER are normally scl up to point to the inEema] 
inLerrupi handler or lo code Lhat sets carry and then performs, an ETL bsck \o [he 
iriiCerrupL niELnagcr. AJi the rqmiines are called in 8-bit native mode and wiih the high 
speed al dala bank register set lo $00 and the direct regLsrer sei tn SOOOO. The called 
rouiiine must reium carry dear if it handled the inLerimpt and carry sci if ii did not 
tiand]e the intermpL Carry clear lells ihe inierrupl manager noL to call the application 
[]r operating ByBtem. Carry set iclls the intcrrupi mmager ihai ihe applicaiion or the 
operating sysrem musl be notified of the current intcmjpL The caEled routines must 
preserve the DBR, speed, 8-bit native mode, and ID register for proper operation. 
A/yJY need not be preserved. Intcrrupis arc disabled on entry to all interrupt 
handlers. The handler must not recnable interrupts from within the internjpi handler. 
AppleTalk and the Desk Manager are allowable exceptions. These vectors should be 
acce5M:d only via the Miscellaneous Tool Set. Their locaUon in memory is not 
guaranteed. 

$El/002a^^2B IRQ.SCAN Jump to scan-line interrupt handler. 

UncondJuonal jump lo the scan-line interrupt handler. 
Used by the Cursor Update rumine. The form of the call 
in memory is as follows: 



I 



SE1/002C-002F 



SE 1/0030-0033 



JEl/0034-0037 



JMP abslong (S5C/1dw byte/high byte/bank b>fie3 



IRQ-SOtnvD 



Jump to sound interrupt handler. 



Unconditional Jump lo the sound interrupE handler. 
Handles all interrupts from the Ensoniq sound chip. The 
form of the call in memory is as follows; 

JMP abslong (S5C/1qw byie/high byte/bank byie) 



IRQ.VBL 



Jump to VBL handlei". 



Unconditional jump lo ihe vertical blanking (VT^O inietrupt 
handler. Tlie form of the call in memory is as follows; 

JMP abslong CS5C/low byte/high byte/bank by(e) 



IRQ. MOUSE 



Jump lo mouse Interrrupt handler. 



Unconditional jump to the mouse interrupt handler. Tlie 
Torm of the call ii\ memory is as follows: 

JMP abslong ($5C/l()w byie/Tiigh byie/bank byte) 



JJ?asCAN ttirough iRQ.OTHER veciofs 
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SE1/0O38-003B 



^El/DO3C-O03F 



iEl/0040-0043 



5E1/D044-0047 



$E1/O048-004B 



IRQ.QTR 



Jump Co quarter-second interrupt 
handler. 



Unoindilional jump to the quarter-second interrupt handler. 
Used by AppleTadk, The form of ihe call in memory is s& 
followai 

]MF abslong <S5C/low byie/htah byte/bank byte) 



IRQ.KBD 



Jump to keyboard interrupt handler. 



Uneondiiional pjmp to Lhe keyboard interrupt handier. 

Cuffenily the keyboard has no hardware interrupt. Keyboard 
jnlemjpts are still available by making i call to the 
Miscellaneous- Tool Sei, [elling ii ld install a heartbeat issV 
thai interrupts every time VBL polls the keyboard. If a key is 
pressed, ihe heartbeaL task will JSL through this vector. This 
forms a quasi-kcyboard intenupE. The form of ihe call in 
memory is as follows: 

JMP ab^long CS^C'low byte/high byie/bank byte) 

IRQ-RESPONSE Jump to ADB response interrupt 
handler. 

Unconditional jump lo the ADB (Apple DeskTop Bus3 
response interrupt handler. The form of the cal] in memory Is 
as follows: 

JMP abslong <35C/Iqw byte/high byte/bank byte) 



IRQ.SBQ 



Jump to SRQ inLernjpt handler. 



Unconditional jump to the ADB (Apple DeskTop Bus) SRQ 
Cservicc rcquesi) internupL handler. The form of the call in 
memory is as follows; 

JMP abslong CS5C/low byie/high byte/bank byte) 



IKQ.DSKACC 



Jump to Desk Manager inlenupt 
handler. 



Unconditional jump to the Desk Manager interrupt 
handler. Invoked by the user pressing Control-C^Esc. The 
form of the call in memory Ls as follows; 

JMP absbna CS5C/low byte/high byte/bank byte) 



Appendix D: Vectors 



m/ii04C-0OAF 



SEl/OO 50-0053 



SE1/0054-Q057 



$E1/O058-005B 



$E1/TO5C-005F 



SEI/OO60-OO63 



IRQ^FLUSH Jump to keyboard FLUSH intcmapi 

handler. 

Unconcliiiona] jump to ihe keyboard FLUSH interrupt 
hindJe/, Invoked by the user pressing Control-0-Backspaoe. 
The form of the call in memory is. as folJows: 

JMP abslong CS5C/]ow byte/high byte/bank byte) 

IRQ.MICRO Jump lo keyboa/d micro abort mterrjpi 

handler 

UncondiUonal jump to the keyboard micro abort rrcovery 
routine. This inierrupi occurs only when the keyboard micro 
has 3 catastrophic failure. If such a failure docs ocoir, the 
firmware will try to rcsynchronize up to the keyboard miao 
and initialize- The form of the call in memory is as follows; 

JMP abslong ($5C/low byie/high b^te/bank byte^ 



IRQ, 1 SEC 



Jump 10 1-second iniermpt handler, 



Unconditional jump to ihe 1-secood inierrupi handler. The 
form of the call in memory is as follows; 

JMP alislong C$5C/]ow byte/high byte/bank byte) 

IRQ.EXT Jump to VGC external inierrupi handler. 

Unconditional jump to the VGC (video graphics chip) 
exLeinal interrupt handler. Currently, the pin that generates 
this interrupt is forced high so (hat no tnterrupi can be 
generaied. This Intermp; handler is for future system 
expansion and currently cannot be used The form of the 
call in memory is as follov^S: 

JMP abslong (S5C/loiv byte;%^ byle/ljank byte) 

IRQ.OTHER Jump to other Jnterrupl handler. 

Unconditional fump 10 an installed imernjpt handler that 
handles iniernjpEs other than the ones handled by the 
iniemal firmware. This is a. general-purpose veaor. The 
form of the call in memory is as follo^-s; 

JMP abslong CJ5C/low byte/high byte/bank byte) 



CUPDATE 



Cursor Update vector^ 



Unconditionsl jump to the Cursor Update routine in 
QuickDraw II. The form of the call in memory is as follows; 

JMP abslong (SSC/low byie/high byte/bank byie) 

IRQ,SCAN ihrough IRQ.OTHEf? vectors 
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JE1/0Q64-O067 



JEl/0a68-0O6B 



$E1/006C-006F 



SEl/0070-0073 



INCBUSYFLG Increment busy flag vector, 

Uncondilional jump to the increment busy llag routine. The 
form of the call in mernQry is as follows; 

JHP abslong (&5CAow byie/high byie/bank byre) 

DECBUSYFLG Decrement busy flag vector, 

UncondiLional jump lo the decrement busy Oag rouline. The 
form of the call In metnory jLs as follows: 

JMP abslong (S5Cyiow byie/hjgh byie/bank byie> 

BELLVECTOR Monitor bell vector intercept routine. 

Unconditional jump to a user- installed BELL rouiitie. The 
Monitor calls ihis routine whenever a BELL character (JS7) 
15 output through the output hooks CCSWIVCSWH $36/J37) 
and whenever BELLI. BELL1.2, and BELL2 are cailed. The 
routine is called in fi^bit native mode and muyt return Lq the 
Monitor in 8-bil native mode. The data bank register and 
direct register must be preserved. Carry must be returned 
clear^ or the Monitor will generate its own bell sound, b^or 
compatibility with esfisting programs, the X register must be 
presented during this calt, and Y must be = SOO on exit from 
this call. The form of the call in memory is as follows: 

JMP abslong C$5C/low byte/high tjyte/bank byte) 

BREAKVECrOR Break vector. 

Unconditional jump to a user-installed break vector. The 
user's rouLine is called in S-bit native mode at high speed, 
with tile data bank register a?l to 500 and the direa register 
set to SOOOQ, The user's routine must preserve the data bank 
[Agister, direct register, and speed and return in 8-bit native 
mode Willi an RTL. 'ITie user's routine must also dear carry, or 
the normal break routine pointed to by the vector at 
SCO/O3FO.05F1 will be called. If csny comes back clear, the 

break interrupt is prcfcessed and. the application program is 

resumed 2 bytes pHSt the BHK opcode, 'mis vector is set vp for 

u-se by debuggers such as the Apple llf^s debugger. The fonn 
of the call in memory is as follows: 

JMP abslong (55C/low bylc/high byteArank byte) 
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5E1/O074-0O77 



TFACEVECTOR Trace vector, 

UncondilionaJ jump la A irace vector. Ttic user's fouline ls 
allcU in 8'biL nalive mode at high speed, with ihe daLa bank 
register set to SOO and the direa register set tg $0000. The 
user's routine mus? preserve Ihe data banJt register, direct 
register, and speed and return in 8-bit native mode with an 
KTL. [fihe user's routine cleans carry, the Monitor firmware 
resumes where it left ofT. If the user sets carry, ihe Monitor 
firmware currcnUy will print Trace on the screen and continue 
where it leQ off. This vector is sel up for use by future system 
firmware and by current debuggers. The form of the ca]l Ln 
memory is as follows: 

JMP abslong ($5C/low byie/hJgh byle/bank t>yic) 



$El/'007S-0O7B 



STEPVECTOR 



Step vector. 



Unconditional jump to a step veaor. The user's rouUne is 
called in 8-bit native mode at hi^ speed, with ihe data bank 
register set to $00 and the direct register set to SOOCO. The 
user's routine must preserve tlie data banJt register, direct 
register, and speed and return in 8-bii native mode with an 
RTL If the user clearij carry, the Monitor firmware resumes 
where it left off. If the user's routine se(s carry, the J^^onitor 
firmware currently wilt prim Step on the screen and continue 
where it left off. This vector is set up for use by future system 
firmware and by current debuggers. The form of the call in 
memory is as follows: 

JMP abslong C$5C/low byte/high byte/bank bvte^ 



SE1/007C-007F 



Reserved for future expansion. 

This vector is reserved for future system expansion and is not 
available to the user. The form of the call In memory is as 

follows: 

JMP abslong C$5C/low byle/high byle/bank byteD 



IRQ.SCAN through IRQ.OTHER v&ctors 
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TOWRITEBR through MSGPOrNTER vectors 

Vectors TOWHITEBR Lhrough MSGPOINTER arc guaianteed lo suy in Oie same 
memory locaiiotis in all Apple EGS-cprnpatible systems. These v-cciors art: fqr 
convenierice and are not to be altered by any application. 

SEl/0a8O-OQe3 



TOWRITEBR 



Wriie BATTEHYRdUl routine. 



Thjs vector poinLS lo a routine ihai copies the 
BATTERYRAM buffer in bank %F.l to [he clock chip 
BATTERYRAM with proper checksutns. This routine is 
called by the Miscellaneous Tool Set and by the Control 
Pane], The form of ihe call in memory is as rollows; 

JMP abslong (SSC/low byte/high byte/bink byte) 



iEl/0O&4-O0S7 



TOHEADBR 



Read BATTER\TlAM routine, 



SEl/0Oa3-O08B 



This vec[or points to a routine that capitis the dock chip 
BATTERYRAJVI \o tJls BATTEHYKAM buffer in bank SET, 
compares the checksums, and if die checksums match, 
retuins to the caller. If the checksums do not match or if one 
of [he values in the BATTERYRAM is out of limits, the system 
defauk parameters are written into the llATTERYRAM buSfei 
in bank SEl and then into the clock chip BATTERYRAM 
w'iih proper checksums. This routinie is called by the 
Miscellaneous 'I'ool Set and by the Control Panel. 'Ihe form 
of the call in memory is as follows; 

JMP abslong C$5C/low byte/high byte/bank byte) 

TOWRITETIME Write time routine 

Tliis veclof points to a routine ihat writes to the seconds 
registers in the clock chip_ It transfer* the values in the 
CLKW'DATA buffer in bank Stil to the dock chip. This rouUne 
is called by the MisceDancou^ Tool Set only It returns carry 
clear if the write opeiaiipn wa5 successful and C3rry set if it 
'R'as unsuccessful. The form of dn^ call in memory Ls as 

follows: 

JMP abslong C$5C/low byte/high bytc.'^ank byte) 
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SE1/0OeC-O08F 



SEl/OOpO-0093 



TOREADTIME 



Read itme routine. 



This vector poin:s to a routine ihat reads from the seconds 

fegisicrs in. the dock chip, Ii [rarisfers the values lo ihe 
CIXRDATA buffer in bank SE3 to the dock chip. This routine 
is called by the Miscellaneous Tool SeE only. [[ reiums carry 
dear if ihe read operation was sucQessfijI and cany set if it was 
unsucceSiSful. The forni of the call In memory ia as follows: 

JMP absslong (35C/low byle/high byte/bank byle) 

TOCTRL.PANEL Show Control Panel. 

ITiis vector points to the Control Panel pfogram It assumes 

Ll was called from the Desk Manager. It uses moat of zero 
page. It RTLs back to the Desk Manager when Quit is chosen. 
The form of the caJl In memory is as follows: 

JMP abslong (i5C/low byte/high byte/bank byte) 



^01/0094-0097 



TOBRAMSETUP 



$El/00pS-O0?B 



Set up system to BATTERYRAM 
parameters routine, 



This vector points to a routine ihat sets up the system 
parameters to match ilie values in the BATTERYRAM buffer. 
In addlrlon, if it Is tailed wiifi cany clear, ii seis up the slot 
configuration (internal vemi'ufi external). If it is called with 
carry set^ it does not set up the slot configuration internal 
versus ejciemaO- BATTERYRAM buffer $E1 values can be set 
via the Miscellaneous Ttiol Set only. The form of the call in 
memory 15 a-5 follows; 

JMP ab^^lung (55C/10W byle/high byte/bank byte) 



TOPRINTMSGS 



Print ASCII string dcsiBnated by ihe 
8-bit accumulator. 



This vector points to a routine that displays ASCII strings 
pointed to by multiplying diL' 8.bj[ sccumulaior times 2 
(shifting it left I bit) and then indexing into the address 
pointer table pointed to by MSGPOINTER (address 

SF-VOOCO' 3-byte pointer). It then uses thai address to get 
the firing to display. This routine is used by the built-in 
Control Panel, by any texi-based KAM Control Panel, 
and by the Monitor (to display messages). The form of the 

call in memyry is as follows: 

JMP abslong ($SC/low byte/high byte/bank byte) 



TOWRITEBR through MSGPOINTER vectors 
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T" 



v.! 4«Ui 



JE1/009C-O09F 



TOPRINTMSG16 



SE1/O0A0-OOA3 



*E1/0QA4-00A7 



SE1/O0A8-0OBF 



PrinL ASCII string designated by ihe 
li5-bjt accumulator. 



This vector points to a rgnjUrte that displays ASCII strings 
poifiLed iQ by the l6-bit A register. Thg accumuialor is used 

to index into the address pointer table pointed to by 
MSGPOTNTHE (address SEl/OOCO; 5-byte pointer). It then 
uses that addi^s 10 get the string to display. This routine is 
used by the butll-ln Control Panel, by any lexi-based RAM 
Control Panel, and by ihe J^onJior (to display messages). 
The form of die call in mcniory is as follows: 

JiMP sbslong C$5C/Jow bytejyhigh byle/banh byte) 

CTRLYVECTOR User Conuol-Y vector. 

Unconditional jump to a user-deHned Control-V vector. The 
user's rojtinf! is called in 8-bit native mode, wiib the data 
bank icgisler set to SOO and die direct register .set lo SOOOO. 
The user's rouiine must pieser\'e the data bank register, direct 
register, and speed and reiurn in emulation mode with an RTS 
from banit $00, If no debugger vector is instailed, the Monitor 
firmware will go to the user's routine via the normal 
ConiroUY vector in bank $00 CUSlcADH O0/O3F8.O3F9.O3FA). 
This vector is set up to be used by debuggers. The form of the 
Call in memory is as follows: 

JMP abslong CS5C/low byte/high byte/bank byte) 

TOTEXTPG2DA Point to Alternate Display Mode desk 
accessory. 

This vector points to the Alternate Display Mode program. It 
assumes it was called from the Desk Manager. It RTLg back to 
Ihe Desk Jtlameer when a key L'j pi^issed 1^ form of the call 
iR ffiSfnofy ig %i fellows; 

JMP ah.'slong (SSCAow byte/high byte/bank byte) 



PR016MU 



PfoDOS iS wu vectors. 



This veaor points to the ProDOS 16 routines- Consult 
ProDOS l6 documents for information about these calls. 
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SEl/OQt:0-0OC2 



MSGPOIPfTER 



Pointer lo all strings used in Control 
Psnei, Aitemate Display Mode, and 

MonJior system messages. 



This 5-byte vector poinis lo the address poinier table that 
points to ASCII strings used by the Control Panel, Altemaie 
Display Mode, and Monitar sysEem messages. It is not 
useful for users. The form of ihe call in memory is as 

follows; 

low byte/high bylc/bank byte 



TOWRITEBR through MSSPOINTER vectors 
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Appendix E 



Soft Switches 



This appendix cyni^ins a list of the Apple IIGS sofi switches— the locations at which 
vafious program-derma b]e system control opuions may be accessed and chajigcd. 
Nole thai this lisiing of soft s-wirdies is provided for reference only. Ydu shouM change 
[he contcnis of a soft swiich only by using the appropriate tool from the toolbox. Refer 
to ihe Apple HGS Toolbox Reference for more information. 



Imporldnt 

If you choose to change the contents of any of the soft switches Cnof 
recomnnended other than by using ths toolbox routFnes) for any bit that 1% IJsted 
herein as undefined, you shourd mask thot bit. In other ^vords, read the current 
contents of Ihe data byte, modify only the blt& ttiot oro dellned, and w,nte the 
contents bock ta the switch location, 



Tables E-1 and E-2 are symbol tables sorted by symbol and address, 



CDOO: COOO 20 lOADR EQU * 

CDOO: COOO 21 KBD EQU * 

f:OQO:00 12 CLRaOCOL dfb C 

CO01:0O 23 SET80COL DPS Q 

CO02:0O 24 EDMAINRAM DFB 

C003:D0 25 FU3CARDRAM DFB 

C004:00 ■ 26 WRH?\INRAM DPB 

CCI05:OC 27 WRCAJffiFtAM DFB 

C0Q6:00 28 SETSLOTCXROM DFB 

CQOBiDD 30 5ETSTDZP DFB 

^009:00 31 SETAXTSf DFB 



;Ail I/O is at $CXXK 

;Bit 7 = 1 if keystroke 
;Blt5 6^0 = Key pressed 
?Disable SO-coluitin atare 
;Enatole SO-column store 
;R^ad from main 4eK RAM 
;Read from alternate 48K RAM 
; Write to main 49K iRAW 
;Write CO alternate 48K RAM 
;Uae ROI^ on cards 

;U3e main zero page/gt^cJc 
,-U3e alternate aeco page/atack 
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C00B:O0 
COOCiOO 
COODiOO 
CODE: 00 
COOFiOO 

C012;00 
C013:Q0 
C014:00 
C015:00 
COie:00 
C017:00 
COlSzOD 

C01A:0Q 
COlB:t>0 
COlClOO 
COlDiOO 
C0ie:OO 

COIF; 00 
C02(]:0O 



C021 
C021 

C021 
C021 
C021 
C021 
COEl 

C021 
C021 
COSl; 

C021 



CO 



CD22 
C022 
CO 22 

C;022 
C022 
C022: 

CQ22: 



32 3ETINTC3E0M 

33 3ETSI.OTC3ROH 

34 CLRSOVID 

35 SET 3 OVID 

36 CLRALTCHAR 

37 SETALTCHAR 

38 KBDSTEIB 

39 RDLGBNK2 

40 RDLCRAW 

41 RDRAMRD 

42 RDRAMWRT 

43 RDCXROM 

44 RDALTaP 

45 RDC3R.0M 

46 RD30COL 
4"; RDVBLSAR 
46 RDTEXT 
49 RDMIX 

5G FlDPAGEZ 

51 REHIRES 

52 ALTCHARbET 

53 ROBOVID 
54 



56 * 

57 * 

50 * 

59 * 

60 * 

61 * 

62 * 



1 



I Enable 
Icolor/ 
I mono 
I 



DFB 





DFE 





DFB 





DFB 





DFB 





DFB 





DFB 





DFB 





DFB 





DFB 





DFE 





DFB 





DFB 





DFB 





CFB 





DFB 





DFB 





DFB 


□ 


DFB 


Q 


DFB 





DFB 





DFB 





DFB 






I 



;Enable internal slot 3 ROM 
,-Enabie external slot 3 ROM 
/Disable SO-column hardware 
; Enable 80 -column hardware 
;Ncirnial LC, flashing CJC 
f'Nonmal inverse, LC; no flash 
.-Turn off keypressed flag 



;B±t 7 
;Bit 7 
?Bit 1 
;Bit 7 
?Kit 7 
.-Bit 7 
;Bit 7 
;Bit 7 
;Bit 7 
;Bit 
;Bit 
;Bit 
;Bit 
;Bit 



1 if LC bank 2 is enabled 

1 if LC RAM read enabled 

1 if reading alternate 4BK 

1 if writing alternate 43K 

1 it using internal ROM 

1 if slot zp enabled 

1 if slo^ e3 Spa ce e n ab l ed 

1 if eo-column store 

1 if not VBL 

1 if text (not gcaphicst 

1 if mixed mode an 

1 if TXTPRGE2 switched in 

1 if HIRES ia on 

1 if alternate character 

set in uae 

,'Bit 7 - 1 if eQ-ealuim hardware on 

; Reserved for future ay3.tem 

expanaion 



HONOCOLOR status byte 



64 * 

65 * 

66 * 



MONOCOLOR bits defined as follows: 

Bit 7=0 enables color, 1 diaables color 

Bita 6, 5, 4f 3, 2, 1, must be 

MONOCOLOR DFE jMonodicome/color selection register 



70 
71 
72 
73 
74 
75 



a 



I I I 
Text color bits 

_t I. \_ 



I 



Background color bits 
I I I 



76 * 



TBGOLOR byte 
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Z77 



C022 
C022 

C022 
C022 
C022 

C022 
C022 
C022 

C022 
C022 
C022 

C022 
C022 
C022 
CD22 
C022 
CQ22 

ca22 

C022 
C022; 
C022 
C022; 



00 



78 


■k 


79 


* 


ao 


w 


61 


* 


B2 


* 


E3 


* 


B4 


* 


85 


* 


8€ 


ir 


a? 


* 


B8 


* 


B9 


■Ir 


90 


* 


91 


* 


^2 


* 


93 


* 


94 


3b 


95 


*: 


96 


*- 


97 


# 


90 


* 


100 





TBCOLOR bits defined aa follows: 

Bits 7, 6, 5, 4 = Text color bita 

Blta 3, 2, 1, Q " BackgrQund. color bits 

Color bits = 
SC = Slack 
$1 a Deep red 

52 = Dark blue 

53 - Purple 

54 ■ Dark green 

55 = Dark gray 

56 = Medium blue 
$1 " Lig'ht blue 
SB =^ Brown 

S9 = Orange 

$A = Light, geay 

SB - Pink 

$C = Green 

SD - ifellow 

SE " Aquamarine 

5F - White 

TBCOLOR DFB Q 



;TeKt/background color selection 

te-giater 



C023i 
C023; 

C023; 

C023: 
C&23; 
CQ23, 
C023; 

CQ23; 

C023; 

C023; 

C023 

C023; 

C023 
C023 
C023 
C023 

C023:00 



102 * 7 

103 *l 

104 * I VGC 

105 *|int 

106 * I active 

107 *1 

loa * 

110 * 

111 * 

112 * 

113 * 

114 * 

lis * 

116 * 

117 * 
lis * 

120 







I I I 
I Isec |Sc9n lExt 
I trit [int lint 
I active I active I 

I I I 



I I r I 

I Isec I Scan | Ext | 
lint [int I int 1 
I enable lenabLe tenable I 
I I [ I 



VGCINT istatua byte 



Bit 
Bit 
Bit 



VGCIMT bits defined S3 follows: 

Bit 7 = 1 if interrupt g'enerated by VGC 
6 = 1 if l^aecond timer interrupt 
5 ■ 1 if scan-line interrupt 
4 = 1 if external interrupt {forced low in 
Apple iiGS} 

Bit 3 must be 

Bit 2 = l-aecond timer interrupt enable 

Bit 1 " scan-line interrupt enable 

Bit = exL int enable (can't cause an int in 
Apple lies) 

VGCINT DFB ;VGC intercupt register 
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n 



I 



C024 


122 * 


7 6 5 4 3 2 1 


Q 


C024 


: 123 * 


1 F 1 1' 1 1 f 


1 1 


CCI24 


: 124 * 


1 Button 1 1 




C024 


: 125 * 


1 status J Delta [ Delta movement 




CC2i 


: 126 * 


fnow isign 




CO 2 4 


: 127 * 

I 12B * 


I.I 1 1 1 1 1 


r 1 


CD24 


A«A** M0U3EDATA byte '^■^^'•'^ 




CQ24 


: 130 « 


MOQSEDATA bits defined as follows: 




C024 


: 131 * 


Bit 7 = button 1 status if reading x data 




ca24 


: 132 * 


button atatuB if reading Y data 




C024 


: 133 * 


Bit 6 =• sign of delta - ' + ' - 1 = '-' 




C024 


: 134 * 


Bits 5, i, 3p 2, 1, = Delta mcivement 




C02 4 


:00 136 


MOUSEDATA DFB ,- X Or Y mouse data register 




C025 


: 139 * 


T 6 5 4 3 J 1 


D 


C025 


: 139 • 


I 1 Update 1 1 1 




C025 


: 140 * 


Open ICIoaedlmod 1 Keypad I Repeat (Ceps Ctrl 


1 Shift 1 


CQ25 


: 141 * 


Apple 1 Apple 1 no k«y j key | active r lock key 


1 key I 


C025 


142 * 


key Ikey [press lactivel 1 active active 


i active | 


C025 


143 * 

144 * 


.. 1 1 1 1 1 


1 1 


C02 5 


*A*A^ KEYMODREG atatuS byte "'^""'^ 




C025 


146 * 


KEYHODREG bits defined as follows' 




C025 


147 * 


Bit 7 - d key active 




C025 


148 * 


Bit 6 ■ A key active 




C035: 


149 * 


Bit 5 = Updated modifier latch without keypress 




C023i 


150 * 


Bit 4 - Keypad key active 




C025; 


151 * 


Bit 3 = Repeat active 




C025; 


152 * 


Bit 2 ^ Caps lock active 




C025: 


153 * 


Bit 1 - Contcol key active 




C025: 


154 * 


Bit = Shift key active 




C025: 


00 1S€ 


KEKMODREG DFB .-Key modifier register 




C026: 


158 * 


"' 5 5 4 3 2 1 


□ 


coac: 


159 *r 


' i r 1 J 1 1 




C026: 


IfiQ *| 


' ■ 1 p 1 




€02 €: 


161 *! 


Data to/from Iceyboard micro 




C026: 


162 *| 






C02e; 


' ie3 *| 

164 * 


1 . i 1 1 1 1 1 




C026: 


"•"""' DATAHEG hufrfl a/.^^.* 
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C026: 
C026: 

C02&: 

C02 6 

coae 
coze 

C02 6 
C02S 

C026: 
C026: 
C026:00 



les * 

167 * 

16S * 

169 * 

170 * 

171 * 

172 * 

173 * 

174 * 

175 * 

176 * 

177 * 
179 



DATAREG hits defined aa follows: 

Bits 7, 6f 5, Af 3, 2f 1, = Data to/from keyboard 

midro 

D9t.a at Interrupt time in thig register defined aa 
f □llDW.3 : 

Bit 1 = Heaponse byte if set; Dtherwiae, status byte 
Bit 6 ■ ABORT valid if set^ and all other bits reset 
Bit 5 = Desktop Manager Jcey sequence pressed 
Bit A = Flush buffer key sequence pressed 
Bit 3 ■ 3RQ valid if set 

Bits 2, 1, 0; if all bits clear, then no Ft)B data 
valid; otherwise the bits indicate the nuinber of valid 
byt#s received minus 1 (2-S bytes total! 



DRTAREG 



DFB ,-Dflta regiatei: in GLQ chip 



C027; 
C0Z7; 

C027: 
C027; 

C027: 
C027' 
C027: 



181 *_ 
IBS *| 
133 *l 
184 *| 
1S5 *| 
196 fc I 
1.87 * 



Mouse 
reg- 

full 



I 



IMouge I Data 
I int I reg 

I enable I full 



I 

■ Data 

lint 

I enable 



Key I Key I Mouse | Cmd 

data lint ix/yeeglreg 
full I enable I data | full 



KHSTATUS byte 



C027 

C027 
C027 

C027 
C027 

c:027 

C027 

C027: 

C027: 
CCI27; 
C027:00 
C028:00 



189 
190 
191 
192 
193 
194 
195 



196 * 

197 * 
I9S * 
200 
201 



KMSTATUS bits defined as follows: 

Bit 7 = 1 if mouse register full 

Bit 6 ■ mouse interrupt disable/enable 

Bit 5 = 1 if data register full 

Bit 4 = data interrupt enable 

Bit 3 ■ 1 if key data full (never use, won't work] 

Bit 2 = key data interrupt enable (never use, won't 

work) 
Bit 1 = ** mouse 'K' register -data available 

1 = ifiOuae "£' register data available 
Bit = Commaind register full 

KH5TATU3 DFB ;Keyboard/'mou5e status register 
ROMBANK DFB ;ROH bank select toggle (not used in 

Apple IlGSl 



2ao 
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1 

C029 


: 203 


« 


f €543210 




C029 


: 204 


k 


1 1 1 1 1 1 1 1 




C029 


: 205 


* 


Enable | Linear |B/W 1 1 1 | 1 Enable | 




C029 


: 2Qe 


n. 


super Jvideo IColorl | 10 10 Ifaank If 




G02S 


J 207 


* 


hi-rea 1 |DHirea| 1 | [ | batch .| 




C029 
C029 


: 208 

: 209 


* 


1 1 1 1 1 1 1 1 


~'"^""^ HEWVIDEO byte '^"^*' 




coag 


: 2H 


* 


NEWVIDEO bits defined aa follows : 




i C0Z9 


212 


fr 


Bit 7=1= Disable Apple He vi^eo (enables super 




C02 9 






Tii-res) 




213 


* 


Bit 6 = 1 to lineariEQ for super hi-cea 




CCI29 


214 


* 


Bit 5-0 foe cdIoc double hi-rea; 1 for B/W lii-'rea 




C029 


215 


* 


Bits 4, 3, 2, 1 muat Ise 




C03 9 


216 


t 


Bit - Enable bank 1 latch to allow long instructions 

to acceag bank 1 directly; set by MDnitor 




C029 


217 


* 


only; a progxammer must not change this bit. 




C029 


00 219 




NEWVlDEO DFE ; Video/enable tead alternate mem 

with long inat ructions 


H 


C02fl 


00 220 




J>WB C ; Reserved for future ayatem 
expansion 


^1 


C02B 
CCI2B 


222 

223 


* 1 


1 65 43 210 


^^M 


1 1 1 1 1 1 [ 1 


^H 


C02B 


224 


* 1 


Character Generator | NTSC^jLang 1 1 1 f 


^^M 


C02B 


325 


k \ 


language select 1 PAL 1 select 10 | | | 


^^M 


C02B 


22& 


■k 1 


1 Ibit 1 1 1 i 


^H 


C02B 


22T 


* 1 


1 1 1 1 1 1 1 r 


^H 


""""^^ LIUJGEELI. bytg '<-r"\r>.^ 


^1 


C02B 


230 


* 


LRMGSEL bits defined as follows: 


^H 


C02BJ 


231 


* 


Bits 7p 6, 5 = Character-generator language selector 


^^M 


C02B; 


232 


* 


Primary language Secondary language 


^H 


C02B: 


233 


* 


50 = Eng-lish (USA) Dvorak 


^H 


C02B: 


234 


* 


$1 = English {UKJ USA 


^^1 


C02B; 


235 


■k 


$2 - French USA 


^H 


C02B: 


236 


* 


S3 = Danish USA 


^H 


C02B: 


237 


it 


^4 = Spanish QSA 


^H 


C02B: 


238 


* 


^5 « Italian USA 


^^1 


CD2B: 


239 


* 


S6 -^ German USA 


^H 


C02B: 


. 240 


* 


$7 = Swedish USA 


^H 


C02B: 


241 


■k 


Bit 4 = if NTSC video mode, 1 if pal video mode 


H 


C02B: 


242 


* 


Bit 3 - LANGUAGE switch bit if primary lang set 
selected 


^H 


Ca2B: 


243 


■k 


Bits 2, 1, must be 


^H 


CO20; 


00 245 




LAWG3EL DFB ^-Language/fAL/NTSC select register 


1 


C02C: 


00 246 




CHARRDM DFB ;Addr for tst mode read of character 

ROM 
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C02D 




24S 


* 


7 


€ 5 


4 3 


2 L 


c 


C02D 




249 


* 


1 


1 1 


1 1 1 


1 1 




C02D 




250 


* 


JSlotT 


1 Slots I Slat 5 |SlOt4 | |Slot2 | Slotl I 




C02D 




251 


* 


1 intexc J inrext | Intext 1 incest | [ intext | IntSitt 1 


1 


C02D 




252 


* 


1 enable I enable I enable lenable 1 | enable 1 enable 1 




CQ2D 




253 

254 


1* 


1 


1 1 


t J 1 


1 1 






' 




:l byce '"■^'^'' 






CO 2D 


""^"^ 3LTR0MSI 




CO 2D 




25S 


* 


3LTR0MSEL bita defined as follows: 






C02D 




257 


> 


Bit 


7 =5 enables 


intecnal glot 7 , 1 


Qnables alot 


ROM 


CD2D 




253 


K 


Bit 


■6 = enables 


internal slot 6, 1 


enables slot 


ROM 


C02D 




259 


* 


Bit 


S = enables 


internal slot 5, 1 


enables aloC 


ROM 


C02D 




260 


* 


Bit 


4=0 enables 


internal slat 4, 1 


enables slot 


ROM 


C02D 




261 


* 


Bit 


3 must be 








C02D 




262 


■t 


Bit 


2=0 enables 


internal a lot 2, 1 


enables slot 


ROM 


CQ2D 




263 


ic 


Bit 


1=0 enables 


internal slot 1, 1 


enables slot 


ROM 


C02D 




264 


* 


Bit 


mugt be 








C02D 


:00 


26g 




Sl,TROMSEL DFB 


;Slot ROM select 






C02E 


.00 


267 




VERTCNT DfB 


r'Addr for read of 


videq cntr bita 














V5-VB 






C02F 


00 


26a 




HORIECNT DFB 


;Addi- foc read of 


video cntr blt3 














VA-HO 






C030 


00 


269 




SPKR DFB 


;Clic]cs th& speaker 




C031 




211 
212. 


* 

*. 


7 
1 


e 5 
1 1 


fl 3 


2 1 





C031 


1 1 I 


1 1 




C031 




2^3 


* 


13. 5-* 


13.5" 1 


\ \ \ 


1 1 




CD31 




274 


* 


Ihead 


1 drive 1 


( C 1 1 


1 1 


1 


C031 




275 


* 


1 Select 1 enable | 


1 1 1 


1 1 




CO 31 




27 6 
277 


* 


t 


1 1 


1 1 1 


1 1 




CCI31 


"'"""^ DISKREG 








C031 




279 


■* 


DISKREG bit3 defined as follows: 






C031 




260 


* 


Bit 


7 ■ 1 to select head on 3.5" drive to uge 




C031 




281 


* 


Bit 


6 = 1 to enable 3.5" drive 






C031 




282 


A 


Bits 5, Af 3, 7.i 1, must be 






C031 


00 


284 




OISK^Q DFB Q 


;U3ed for 3,5" die 


k drives 




CQ2Z 




2B£ 

297 


A 
A 


7 


fi 5 


4 3 


2 1 

1 1 





C032 


1 1 


1 1 \ 


1 


G032 




2B8 


* 




IClear IClear 1 1 | 


1 1 


1 


C032 




299 


* 


Q 


|1 sec 1 scan 


1 1 1 


:) 1 1 


1 


C032 




290 


* 




flnt |ln inti 1 1 


1 1 


1 


C032; 




291 
2 92 


* 




1 1 


1 \ 1 


1 1 


1 


C032: 


AAAAA SCAWINT 









202 
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^■^C032 


294 * 


SCAMINT bits defined as follows: 


^m C032 


295 * 


Bit 7 nm3t be 


^M C032 


296 * 


Bit 6 = Write here to reaet l-aecond interrupt 


^M C032 


291 * 


Bit 5 = Write here to clear acan-line intecrupt 


^M C032 


2 9B * 


Bit 4 must be 


^^ CO 32 


299 ' 


Bit 3 must be ' 


^M C:032 


300 « 


Bit 2 must be 


^H C032 


301 * 


Bit 1 mu3t be 


^M C032 


302 * 


Bit must be n 


^1 C032 


00 304 


SCANINT DFB ;SGan-line interrupt register 


^1 co3a 


306 *_ 


1 6 5 4 3 J 1 Q 


^M C033 


30 T *1 


f 1 1 1 j 1 1 1 


^1 C[)33 


308 *| 




^M CD33 


309 *| 


Clock data register | 


^1 CO 33 


310 *| 


1 


^1 CO 33 
^M CO 33 


311 *| 

312 * 


1 1 1 1 1 1' 1 1 


A^AAA CLOCKDATA byta ^-^'-'^ 


^H C033 


314 * 


CLOCKDATA bits defined aa follows: 


^B CC33 


315 * 


Bits 7, 6. ^, 4j 3r 2, If Q = Data parsed to/from clock fl 

chip ji 


^1 C033 


00 317 


CLOCKDATA DPB .Clock data cegistei: 1 


^H C034: 
^M t034 


319 * 

320 *| 


f 6 3^3210 I 


1 1 1 1 r 1 1 1 1 


H C034: 


321 *| Clock IRead/ 1 Chip | | ' 1 


H C034: 


322 *|xfer IWrite lenablel | Boirder color | J 


H C034: 


323 *[ 


Ichip 1 assert |l 1 1 1 


^1 C034: 


324 *| 

32 5 * 


1 1 1 1 1 1 1 f 1 


AAA^rt CLOCKCTL byte '''^'•*'^ H 


^1 CD34: 


327 * 


CLOCKCTL bits defined as follows ; 1 


H c:Q34: 


32B * 


Bit 7 = Set - 1 to start tcanafer to clock N 


^1 C034: 


329 * 


Read = wftsn transfer to clock is complete H 


H CQ34: 


33 * 


Hit 6 ■ =* Write to clock chip* 1 = Read from clock ff 

chip 1 


^1 C03'i: 


331 * 


Bit 5 = Clk chip enable assorted after tt'^nsfec 
- no/ I = yes 


H C034: 


. 332 * 


Bit 4 must be 


^M CD34- 


333 * 


Bitg 3, 2f 1, = Select bord&r color (see tbcgi^h foe 

vaiueaj 


H C034 


00 335 


CLOCKCTL DFB /Clock control register 
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C035 




337 


* 


7 




S 5 




4 3 2 L Q 


C035 




338 


A 1 








1 1 r 1 1 1 


C035 




339 


* 1 






Stop 


IStop IStop 1 Stop 1 Stop IStop 1 


C035 




340 


* 1 







I/O/LG 


1 auKh-r 1 suprhr | hireg2 | hires 1 I tstpg [ 


CO 35 




341 


* 1 






shadow 


f shadow 1 shadow 1 shadow | shadow I shadow [ 


CD35 




342 
343 


* 1 








1 1 1 J 1 1 


C035 


^f,^^r. SHADOW 


byte '•'^'^^^ 


C035; 


345 


■* 


SHADOW bita defined aa follows: 


C035: 


346 


*■ 


Bit 


7 


must write 





C035: 


347 


* 


Bit 


6 


*= 1 to inhibit I/O and language -card operation 


CQ35: 


34B 


* 


Bit 


5 


mu3t write 





C035: 


34& 


* 


Bit 


4 


■= 1 to inhibit snatiowing' aux Iti-rea p&ge 


C035: 


350 


V 


Bit 


3 


^ 1 to inhibit shadowing 32K video buffet 


CQ35: 


351 


it 


Bit 


2 


- 1 to inhibit shadowing hi-rea page 2 


CQ35: 


352 


* 


Bit 


1 


= 1 td inhibit shadowing hi-rea page 1 


C035: 


353 


* 


Bit 


□ 


= 1 to inhibit shadowing text pages 


C035:00 


355 




SHADOlfl DFE 


; Shadow j^ggigter 


C03fi: 


357 
35S 


* 


7 




S 5 


4 3 2 10 


case 








1 


1 1 1 1 1 


C036 




359 


* 


Slow/ 






IShadoHlSlot 7 1 Slot 6 1 Slot 5]Slot 4 


C036 




360 


* 


fast 




1 Q 


1 in alllmotor Imotor Imotor ilmotor 


co3e 




361 


it- 


speed 






1 RAM 1 detect 1 detect | detect ] detect 


CO 3 6 




362 
363 


* 

* 








1 1 1 1 1 


C036 


' 


^ yi d< 


^"-^ CYAREG 




CQ3e: 


365 


IT 


CYAEEt 


r bits cleEinscl ss follows: 


C036: 


366 


* 


Bit 


7 


= = Slow 


System Speedy 1 = Fast system speed 


C03€: 


367 


•t 


Bit 


6 


must write 





CQ3G: 


368 


■R 


Bit 


5 


must write 





Ca36: 


369 


* 


Bit 


4 


■ Shadow in all RAM banka (never uae) 


C03€: 


370 


* 


Bit 


3 


= Slot 7 disk irotDr on detect (set by Monitor 












onlyj 




Ca36: 


371 


* 


Bit 


2 


- Slot 6 disk motor on detect (set by Monitor 












only) 




CQ36: 


372 


« 


Bit 


1 


= Slot 5 disk motor on detect {set by Monitor 












omly) 




C036; 


373 


* 


Bit 


D 


= Slot 4 disk ffiotoi: on detect (set by Monitor 












only) 




CQ3G:00 


375 




CYAREC 


t DFB 




Speed and matnr on detect 


C037:OO 


37 e 




DMAREC 


i DFE 




Used during DKA as bank address 


C038:00 


37 7 




SCCBRi 


3G DFB 




sec channel B cnid register 


0039:00 


37 




SCCARI 


:G DFE 




sec channel A cmd cegister 


C03A:00 


379 




SCCBDJ 


LTA DFB 




sec channel B d3ta register 


C03B 


00 


3eo 




SCCADi 


^TA DFB 




■sec channel A data register 
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MAHMi 



L>^^j» fiJJitJw 




C03C 
C03C 
C03C 

C03C 

C03C: 

C03C; 
C03C: 

C03C; 
C03C; 
C03C: 
C03C: 

C03C: 

C03C: 

C03C:00 

CO 3D: 
C03D; 
C03D: 
C03D: 
C03D; 
CQ3D: 

C03D: 

C03D: 
C03D: 

C03D:00 

C03E: 
C03E; 
C03E1 

C03E1 
G03E, 
C03E 
C03E 

CQ3EE 
CCI3E: 

CCi3E:ClO 



392 * 

393 *' 

3a4 * 

335 * 

336 •! 

337 * I 
388 * 

390 * 

391 * 

392 * 

393 * 

394 * 

395 * 

396 * 

398 

400 •_ 

401 *| 
^02 * I 
403 * I 
i04 *] 

405 *| 

406 * ' 

408 * 

409 * 

411 



Busy 
flag- 



I Auto I Acceas 
I doc/ Hint 
I RAM I adrpt c 



Volume DAC 



JhA.A A.A 



SOUHDCTL byte 



SOUHDCTL bitfl defined as follows: 

Bit 7 = if not busy, 1 if busy 
Bit 6 - = Aceeag doc, 1 = Access RAM 
Bit 5 ■■ □ >=■ Disable auto incrementing of address 
pointer 
1 = Enable auto incsementin^ of address pointer 
Bit 4 muat b& 
Bits 3, 2, 1, = Volunw DftC-50/$F = Low/lull volume 

(write only) 
3GUMDCTL DFB ; Sound control Esgistei; 

_"? 6 5 4 3 3 t 



Sound data read/written 



SOUNDDATA byte 



413 


* 


414 


*l 


415 


*t 


416 


*l 


417 


*l 


41S 


*l 


419 


* 


421 


w 


422 


*: 



SOUWDDATA bltS defined ag EollOwS: 

aits 7, S, 5j 4, 3, 2, 1, = Data read from/written to 

sound RAM 
SOUNDDi^TA DFB Q ; Sound data register 



6 



I I I I I 

Low byte of sound address pointer 

I l_ I I I 



SOUWDADRL byte 



A A A A Jh. 



424 



SOUNDADRL bits defined as follows: 

Bits 1, &f 5, 4, 3, 2, 1, ■ A<ie3res3 into soun^J RAM 

low byte 

SOtJNDADRL DPS ; Sound address pointer, low byte 
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2S5 



pwrr 



CID3F 
C03F 

C03F 
C03F 
C03F 
C03F 
C03F 

C03F; 

C03f-: 



426 

427 

429 
430 
431 
432 



*T 

*i 
*i 
"I 



6 5 A 3 2 

I I I I I 

High byte of aound ad-dresa pointer 



I 



I 



^ A^ rt^ 



SOUND ADRH tjyte 



S0UWDW5RH bits defined as follows; 

Bita 1, 6, 5p Af 3, 2, 1, tJ = Addreaa into 30Und RAM 

high byte 
SOUNDADRti ore fV ; Sound address pointet, high byte 
DFB ^Reserved fot future ayatem 
e>:pan3iofi 

♦ Note: TTie Mega ii mouse is not used undec Apple IIGS as a mouse, but the 

soft switches and functiona are used. ThereEore, the programmer may not 
use the Mega II mouss soft gwitcJies . 



C03F:00 
C040:00 



434 * 

435 * 

437 
438 



CO 41 
CO 41 
C041 
CO 41 
C041 
C041 
C041 



C041: 

C041: 
C041: 
CO 41: 
C041: 
C041: 
CD41: 
CQ41: 
C041: 
C041;00 

C042:00 

C043:00 



4 40 



44Q 
449 
450 
451 
452 
453 
454 
455 
45E 
458 

459 

460 




I I I I I 
I Bnable | Enable I Enable I Enable I Ensbls 
|l/4sse I VBL I switch limove Imouge 
I intS' I inta I ints I ints I 



INTEN 
Bit 1 
Bit 6 
Bit 5 
Bit 4 
Bit 3 
Bit 2 
Bit 1 
Bit 
IHTEN 



INTEN byte '■' 



bits defined aa followg; 
muat be 
must be 
mugt be 

= 1 to enable quarter-second interrupts 

= 1 to enable VBL interrupts 

■ 1 to enable Mega Ii mouge awitch intereupts 

" 1 to enable Mega II mouse movement interrupts 

= 1 to enable Mega II mouse operation 

DFB ; Interrupt-enable register (firmware 

use only) 
DFB ;Re3ecved far future system 

expansion 
DFB ; Reserved for future system 
expansion 
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CO-14: 

C044: 
C044: 



462 



C04 4: 



463 * 1 


1 1 1 1 1 1 1 1 


464 *| 




465 *| 


Mega II Mouse clelta movement byte | 


466 * f 




457 * 1 


1 1 1 1 1 t 1 1 


468 * 


----- MMDELTAX bvte -'^-^-^ 



C0441 

C0.44: 

C044;0Q 

C045: 
C043: 
Ca45: 
C045: 
C0^3: 
G045: 
C0^5: 

C045:00 



C04 6 

co4e 

C04S 

C04 6 

C04 6 

co4e 

C046: 
CO 46: 

C046: 

C046: 



470 * MMDELTAX bits defined a3 follows: 

471 * Bita 7, 6, 5, 4, 3, 2, 1, = Delta moveinent in 2's 

complement notation 
473 MHDELTAX DFB ;M6ga II mouse delta X tregiater 




HMDELTAT byte "'"^'' 



MKDEliTAY bits defined as follows: 

Bits 7, 6r 5, 4, 3, 2, 1, - Delta movement in 2' a 

complement notation 
MMDELTAY DFB ;Mega II mouse delta Y register 



433* 
434 * 

436 

4 88 * 7 e ^5 ^ 

499 * I I I I 

490 *|SeXf/ IMMouselStatus IScatus 

491 *1burnin | last [flW3 |l/43ec 
4 92 *ldiags I button! lint 
493 *| 1 I I 



Status I Status I St a tug ! Status I 
UBI, I switch Imove I system I 
idt I Int ] int | I 



496 


* 


497 


* 


499 


■k 


499 


*i 



DIAGllfPE bits defined as follows: 

Bit 7 = if self-diagnostics get used if BUTNO = 

l/BUtNl = 1 
Bit 7 = 1 if t>ucn-in diagnostics get used if BUTNO 

1/EUTNl - 1 
Bita 6-0 = Same as INTFLAG 
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CQASi 501 

C04 6; 5 02 

C046: 503 

C046; 504 

C046: 505 

C046: St>£ 

CD46; 507 

Ca46: 509 

C046: 510 

C046: Sii 

C046; 512 

C046: 513 

C046: 519 

C046: 515 

€04^: 516 

C046: 517 
C046: C046 519 

CQ4e:00 520 

C04'?:00 521 

C048:00 522 

0049:00 523 

C04A:00 524 

C04B:00 525 

C04C:00 536 

C04D:00 527 

C04ElOO 52S 

C04r:00 529 

C050:QO 530 

C051:DO 531 

CD52:00 532 

C055:DO 533 

CQ54;00 534 

CCI55;00 535 

COStiOO 535 

COS7:00 537 

C058:00 538 



* 7 

*l 

* I KHouse 

* I now 

*1 but Con 



g 



4 



I ^ I I 1 I I 

I MMDuse I Status I status I status l Status I Status | status 
Hast rAN3 |l/43ec|VBL |awltCh|move I ay stem 
IhuttonI I int I int | int I int I IRQ I 

.1 L I. f I I I I 



^^^^^ TNTFLflG hyte ''*^'*'' 

IMTFLRG bits defined as follows.: 

Bit 7 = 1 if mouse button currently down 

Bit 6 = 1 if mouse button was down on laac read 

Bit 5 - Status of AN3 

Bit 4 = 1 if quarten-aecond interrupted 

Bit 3 = 1 if VBL interrupted 

Bit 2 - 1 if Mega II mouse switch interrupted 

Bit 1 = 1 if Mega II mouse movement interrupted 

Bit - 1 if ayatem IRQ line ia as.serted 



DIAG*rTPE 

INTFIAG 

CuRVBLINT 

CLRXYINT 



ITXTCLR 

TXTSET 

MIXCLR 

MIXSET 

TXTPAGEl 

TXTPAGE2 

LORES 

HIRES 

SETANO 



EQU * 
DFB 

DFB 

DFB 
DFB 

DFB 

DFB 

DFB 
DFB 
DF3 

DFB Q 

DFB 
DTB 
DFB 
DFS 
DFB 
DFB 
DFB 
DFB 
DFB 



;0/l Self/burn-in HI ftcnin^^i- -i n^i 
; Interrupt flag register 

;Clear the VBl,/3.75Hz interrupt 

;Clear Mega II mou&e interrupt flags 

; Reserved tot future s^fsteni f 

expansion 

/Reserved for future eystem 

e>:pansion 

; Reserved £or future system 

expand ion 

; Reserved for future system 

eKpanaion 

; Reserved for future system 

expinsion 

jReaerved for future system 

expansion 

; Reserved for future system 

expansion 

,'Switqh In graphics (not textt 

; Switch in text fnot graphlcp> 

;Clear mixed mode \'.m* 

;Set mixed mode M lines text I 

,' Switch in text page 1 

/Switch in text pag-e 2 

;Law-cesolutiQn graphics 

; High -resolution graphics 

; Clear annunciator 
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B C05g;00 


539 




CLRANO 


DFB 


Q 


1 

1 
; Set annunciator 




H CCl5A:D0 


540 




SETAWl 


DFB 





; Clear annunciatOEl 




H C05B;00 


541 




CLRANl 


DFB 





; Set annunciator 1 




H C05C:00 


5^2 




SETAN2 


DFB 





.-Clear annunciator 2 




H C^SD-.dd 


543 




CLRAN 


DFB 





; Set annunciator 2 




H COSE; CO 


544 




SETAN3 


DFB 





/Clear annunciator 3 




H Ct}5F:CI0 


545 




CLRAN3 


DFB 





;Set annunciator 3 '| 




H co€a:OQ 


546 




BUTN3 


DFB 





;R^ad switctl 3 




H ::Q£1:00 


5 47 




BUTNO 


DFB 





;Read awiteh (C5 k^y) 




H CDe2:Q0 


5 48 




BDTHl 


DFB 


Q 


;Ftead switch 1 (# key) 1 




H CDe3:G0 


549 




BUTW2 


DFB 





.■Read switch 2 




H C()64:00 


550 




PADDLO 


DFB 





;Read paddle 




H C065;00 


551 






DFB 





;Read paddle 1 




H CQ6g:0Q 


552 






DFB 





;Read paddle 2 




H C067:00 


553 






DFB 





fRead paddle 3 




■ C06&: 


555 


ic 


7 


6 


5 


4 3 3 10 




H COgS: 


358 


*] 


1 


1 




1 1 1 1 1 1 




H coas: 


557 


*IALTZP IPAGE2 IRAMRD 


1 RAHWHT 1 RDROM | LCBNK2 | ROMB f INTCX | 




H COEB: 


556 


* 1 status 1 status | status I scatus I status ] status | status | status I ' 




H €068: 


559 


*l 


1 


1 




1 1 ] E 1 1 




H CObB: 

H cosa: 


561 


*l 

* 


1 


1 




J 1 !l 1 1 1 1 




AAA ^j 


* STATEFtEG 






H COSB: 


563 


* 


STATEHEG bita defi 


ned as follows: 




H C06B: 


564 


Jc 


Bit 7 = 


ALTZP status 




H C06a : 


565 


+ 


Bit 6 = 


PAGE2 Status 




H CO 63: 


S66 


* 


Bit 5 = 


RAMRD status 




H CQ6e: 


567 


* 


Bit 4 = 


RAMWST 


Sta 


IU9 




H CQ6d: 


56fi 


+ 


Bit 3 * 


RDROM Status {read only BAM/B,OM (0/1) J 




H CC€e: 


570 


it 


Important note 


: Pe 


rform two reads to SC0S3; then change 




H CC6@: 


571 


1c 


STATEREG to change 


LCHAH/ROM banks (0/1),- keep ttie 




H CGSB; 


572 


A 


langnage cacd write enabled* i 




H C06S: 


573 


» 








1 




H COGS: 


575 


* 


Bit 2 = 


LCBWK2 


status = LC bank 0, 1 - lc bank 1 




H CD&S: 


576 


* 


Bit 1 -^ 


ROHBANK status 




H C066: 


577 


* 


Bit = 


IMTCXROM status 




■ C06a:0Q. 


575 




STATEREG ors 


D 


; State register 




■ CQ59:00'' 


560 






DFB 





; Reserved for future ayatem 
expansion 




H CQGAiOQ 


581 






DPB 





;Reserved for future system 
eapansion 
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C0SB:QO 

C0 6C:00 

C0 6l>:00 
CQ6E;00 

CCI6F:00 
C070:00 
C:071j 
CO8O:0O 

C08a:00 

Ci}B2:00 
C083:00 

CCiS4:00 

C0S5:OD 

C086:OG 

CD87:00 

COB9:00 

C0BA:O0 
COSBiOO 

C08C:OO 

CO Sd : 

COBEiDO 
c09r:00 

0000:610 
0a00:6l2 



382 




DFB. 


583 




DFB 


584 


TESTREG 


DFB 


585 


CLRTH 


DFB 


53e 


ENTH 


DFB 


581 


PTRIG 


DFB 


5se 




ns 15, 


590 




DFB 



LCBANK2 



59 1 HOMIH 

592 

593 

595 

596 

597 
598 

600 

601 

602 
603 

605 

60€ 

607 
608 

DEHD 
CUmOM EQU 



LCBANKl 



DFB 

DFB 
DFB 

DFB 

DFB Q 

DFB 
DFB 

DFB 

DFB 
DFB 

D^-a 

DFB 
DFB 
DFB 

DFB a 



;R@secve<l for future gyatem 
expansion 

;Re3erved for future system 
expansion 

; Teat inode bit ^eegiater 
/Clear teat mod^ 
.-Enable teat mode 
; Trigger the paddles 
■ ;!rom interrupt code jump table 
;£el LC RAM bank2 rd, wrh protect LC 
ElAM 
; Enable ROM re^d, 2 reads wrt ents LC 

RAM 

; Enable ROM cead, wrt protect LC RRM 

;SeI LC RftM bank2^ 2 rds wrt nent LC 

RAM 

; Sel LC RAM bank2 rd„ wrt protect LC 

RAM 

; Enable ROM read, 2 resdg wet enfa LC 

RAM 

; Enable ROM read, wrt protect LC RAM 

fSel LC RAM bank2, 2 rds wrt enb LC 

RAM 

;3el LC RAM bankl rd, wrt protect LC 

RAM 

; Enable ROH read, 2 reads wrt enb LC 

RAM 

; Enable ROM read, wit protect LC RAH 

;Sel LC R?J^ bankl, 2 rd3 wrt enb LG 

RAM 

;Sel LC lElAM. banfcl rd, wrt protect LC 

RAM 

;Enable ROM read, 2 reads wrt enb LC 

HAM 

^Enable ROM read, wrt protect LC ram 
;Sel LC RAH bankl, 2 rds wrt enb LC 
I^AM 



SCFFF .-Switch out 3CB ROMs 
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Tablo E-] 












SymboJ table sorted by symbol 










€01 E 


ALTCHARSET 


C061 


BUTTs^O 


CO62 DUTN1 


C063 


B11TN2 


C06Q 


liUTN3 


C02C 


CHARROM 


CO54 CLOCKCTL 


C033 


CLOCK DATA 


CQ(H) 


CLR80COL 


cooc 


CLR80VID 


COOV. CLRALTCHAII 


C059 


GLRA^'O 


C05Q 


CLRAN1 


C05D CLRAN2 


C05F CLRAN3 


CFFF 


CI-HROM 


C06E 


CLRTM 


C047 


CLKVBUNT 


QQAs c;lrxyint 


C0S6 


CYAKEG 


CQ26 


DATAREG 


C046 


DIAGTYPE 


CO3I DISKREG 


ca37 


DMAREG 


C06F 


ENTM 


G057 


HIRES 


C02F HOKiZCNT 


C041 


TNTEN 


C046 


nsTFIAG 


COOO 


lOADR 


CO 10 KUDSTRB 


COOO 


KBD 


C025 


KEY.MODREG 


C027 


KMSTATUS 


C02B LANGSEL 


C08B 


LCBANKl 


CC1&3 


LCBANK2 


C056 


LORES 


C052 MIXCLH 


C053 


MIXSET 


CQ^-I 


M.MDE.LTAX 


C045 


MMDELTAY 


C021 MONOCOLOR 


C024 


MOUSE DATA 


C029 


NEWVIDEO 


C064 


PADDLO 


C070 PTRIG 


coia 


RD30COL 


COIF 


RDSOVID 


C016 


RDALTZP 


COT 7 RDCiiROM 


C003 


RDCARDRAM 


CQ15 


RDCXROM 


COID 


RDHIRES 


C0]1 RDLCBNK2 


C012 


RDLCRAM 


COO 2 


RDMAtNRAM 


COIB 


RDM IX 


COIC RDPAGE2 


C013 


RDRAMRD 


CQH 


RDRAMWRT 


COtA 


RDTEXT 


COI9 RDVBLBAR 


co2a 


ROMBANK 


C081 


ROM IN 


C032 


5CANINT 


C03B SCCADATA 


C039 


SCCAREG 


C03A 


SCCBDATA 


C03S 


SCCBREG 


C001 SET80COL 


GOOD SETBOVID 


COOF 


SETALTCHAR 


COO? 


SETALTZP 


C058 SETA NO 


CO 5 A SETANl 


C05C 


SETAN2 


COSE 


SETAK3 


COOA SETINTC3ROM 


C007 


SETINTCXROM 


COOB 


SETS I.OTC3 ROM 


C006 


SETS LOTCX ROM 


COOS SETSTDZP 


CO35 


SHADOW 


C02D 


SLTROMSEL 


C03F 


SOIJNDADRH 


C03E SOUNDADRL 


C03C 


SOUNDCTL 


C03D 


SOUND DATA 


C030 


SPKR 


CO68 STATER BG 


C022 


TBCOLOR CO6 


C06D TESTEEG 


C050 


TXTCLR 


C0S4 rx'lVAGEl 


C055 


TXTPAGE2 


C051 


TXTSET 


C02E 


VERTCNT 


CO23 VGCLVF 


C005 


WRCARDRAAt 


C004 


WRMAINRAM 













nrnm 
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Tabl« E-2 










SymboJ table sorted by 


address 








COOO lOADR 


COOO 


KBD 


COOO CLRS0C:OL 


COOl SET80COL 


C002 RDMAINRAM 


C003 


HDCARDRAM 


C004 WKMAINRAM 


COO5 WRCARDRAM 


C006 &ETSLOTCXHOH 


C007 


SETINTCXROM 


CO08 SETSTDZP 


COO? SETALTZP 


COOA SETTNTC3ROM 


COOB 


SETSLOTC3ROM 


COOC CLR80V1D 


GOOD SET80VID 


COOE CLIULTCl-lAR 


COOF 


SETALTCHAR 


COlO KBDSTRB 


con rdlc;bnk2 


C012 RDLCRAM 


C013 


RDRAMRD 


CO! 4 RDRAMWRT 


C015 rdcxrom 


C016 RDA1.T2P 


C017 


HDC3ROM 


COlS RDSOCOL 


C019 RDVBLBAR 


COIA RDTEXT 


CO IB 


HDMIX 


COIC RDPAGE2 


CO ID RDRIRES 


COlE ALTCHAS5ET 


COIF 


HD80VID 


C021 MONOCOLOR 


C0Z2 TBCOLOR 


C023 VGCINT 


CD2^ 


MOUSF_DATA 


CO25 KEYiMODREG 


CO26 DATAREG 


C027 KMSTATUS 


C028 


ROMHANK 


C039 NEW'VIDEO 


C02B LANGSEL 


C02C CHARROM 


C02D 


SLlTtOMSEL 


C02E VERTCNT 


C02F HORIZCNT 


C030 SPKR 


CO31 


mSKREG 


CO32 SCANINT 


CO33 CLOCKDATA 


CO34 CLOCKCTL 


C035 


SHADOW 


C03^ CYAREG 


C037 DMAREG 


C03e SCCBREG 


C039 


SCCAREG 


C03A SCCBDATA 


C03B SCCADATA 


C03C SOUNDCTL 


C05D SOUKDDATA 


C03E SOUNDADR] 


C03F SOUNDADRH 


CQ41 IWiLN 


C044 


MMDELTAX 


CQ4S MMDELTAY 


CQA6 DIAGTYPE 


C046 INTFLAG 


C0^7 


CLRVBLINT 


C04B CLRXYINT 


CO 50 'DCrCLR 


C051 TXTSET 


C0$2 


MIXCLR 


C053 WrXSET 


C05i TMPAGEl 


CO55 TXTPAGE2 


CO 5^ 


LORES 


C057 HIRES 


CO 58 SETANO 


C059 CLRANO 


ca5A 


SETANl 


C05B CLRAM 


C05C srrAN2 


C05D CLRAN2 


C05E 


SETAN3 


C05F CLRAN3 


CO6O BUTN5 


CO61 BUTNO 


CQ62 


BUTNl 


C063 BUTN2 


C064 PADDIO 


C068 STATEHEG 


C06D TESTREG 


COSE CLRTM 


C56f entm 


C070 PTRIG 


C081 


ROM IN 


C083 LCBANK2 


COSB LCBAMKl 


CFFP CLKROM 
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Appendix F 

Disassembler/ 
Mini-Assembler 
Opcodes 



This appendix SIsts all of the 65C81S inslrucUona and ihe instruction formats that the 
disassembler uses to define the contents of die disassembly. You may wish to hand- 
assemble vahous short routines. This listing provides you with a ready refGionec for 
ihe 6^C816 insmjctions and addressing modes. Sometimes as the table begins a new 
alphabetic item in the nam.e field, a line break is inserted for itadability For cases 
where the insirucUons are closely related to each other (such as branch instrucUons, 
push instructions, and pjll instructions), the line break is omiiied 

In the table that follows, the addressing modes oF the processor are sl^ireviated aa 
shown on the following page. 
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!.!^^rJ>t^v4Jiii^tf> wn 



FTTSm 



Abbraviaiion for 


A&lual addr«tjjng 


addressing mod* 


moicJe rspraienlqd 


# 


InimcdiaLe 


(ai 


Absolule indirect 


U.x) 


Absolute inUcKed ifidifcct 


(d!) 


Direct indirect 


Cd),y 


Direct indirect indexed 


(d,x) 


Direct indexed indirect 


(f,s),y 


Stack fcEaiive indirect indexed 


a 


Ahstjlute 


a,x 


Absoiuie indexed (with ji} 


a.y 


Absolute indexed Cwiih y) 


Ace 


Accumulator 


aJ 


Absolute long 


al,x 


Absolute indexed long 


d 


Direct 


d.x 


Direct indexed (with x> 


d.y 


Direcl indexed (with y) 


I 


Implied 


r 


Program counter relative 


r,a 


Stick relative 


fl 


Program cgiunter relative long 


5 


Stack 


xya 


Block move 


id] 


Direct indireci long 


fd].y 


Direct indireci indexed lone 
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Cpcod* 


Name 


Mod* 


Bytoj 


number 


ADC 


(d) 


2 


72 


ADC 


(d}.y 


2 


71 


ADC 


(d,x) 


2 


61 


ADC 


(f.s),y 


2 


73 


ADC 


d 


2 


65 


ADC 


d.y 


2 


75 


ADC 


f,S 


2 


63 


ADC 


[d] 


2 


67 


ADC 


W],y 


2 


77 


ADC 


# 


2 3) 


69 


ADC 


a. 


3 


6D 


ADC 


a,x 


3 


7D 


ADC 


a,y 


3 


79 


ADC 


al 


4 


6F 


ADC 


alpK 


4 


7F 


AN'D 


(d:) 


2 


^ 


AND 


W),y 


2 


31 


AKD 


Cd,x) 


2 


21 


AND 


<r,s),y 


2 


33 


AND 


d 


2 


25 


AND 


d,>: 


2 


3S 


AND 


f,S 


2 


23 


AND 


[at 


2 


27 


AND 


[d],y 


2 


37 


AND 


# 


2 (3) 


29 


AND 


a 


3 


2D 


AND 


a,jt 


3 


3D 


AND 


a,y 


3 


39 


AND 


al 


4 


2P 


AND 


al,x 


4 


3F 


ASl 


Ace 


1 


OA 


, ASL 


U 


2 


06 


i ASL 


d^x 


2 


16 


' ASL 


a 


5 


OE 


ASL 


A.K 


3 


IE 


BCC 


I 


2 


90 


BC5 


T 


2 


BO 


BCQ 


r 


2 


FO 









Opcode 


Noma 


Mods 


By^ss 


■number 


BIT 


d 


2 


24 


BIT 


d,x 


2 


34 


BIT 


* 


2 03 


89 


BIT 


i 


3 


2C 


BIT 


a,x 


3 


3C 


BMl 


r 


2 


30 


BNE 


r 


2 


DO 


BPL 


r 


2 


10 


BRA 


r 


2 


m 


BRK 


i 


2 


oo 


BRL 


rl 


3 


82 


BVG 


r 


2 


50 


BVS 


r 


2 


70 


CLC 


i 


1 


18 


CLD 


I 


1 


D8 


CLI 


i 


1 


58 


CLV 


t 


1 


BR 


CMP 


(d) 


2 


D2 


CMP 


(d3,y 


2 


Dl 


CMP 


<d.x> 


2 


CI 


CMP 


(I'nSj.y 


2 


D3 


CMP 


d 


2 


C5 


CMP 


d,x 


2 


D5 


CMP 


r,s 


2 


C3 


CMP 


Id] 


2 


C7 


CMP 


[d],y 


2 


D7 


CMP 


* 


2 G) 


C9 


CMP 


a 


3 


CD 


CMP 


a,x 


3 


DD 


CMP 


a.y 


3 


D9 


CMP 


al 


4 


CF 


CMP 


al,x 


4 


DF 


COP 


i 


2 


02 


CPX 


d 


2 


E4 


CPX 


M 


2 6) 


EO 


CPX 


3. 


5 


EC 
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Opcode 


Nam* 


Moda 


Bytas 


numbsr 


cpy 


d 


2 


C^ 


CPY 


# 


2 C33 


CO 


CPY 


a 


3 


cc 


DEC 


Ace 


1 


3A 


DEC 


d 


2 


C6 


DEC 


d,x 


2 


d6 


DEC 


a 


3 


CE 


DEC 


a,x 


3 


DE 


DEX 


i 


1 


CA 


DE¥ 


i 


1 


88 


EOS 


Cd) 


2 


52 


EOR 


UXy 


2 


51 


EOH 


Cd,s3 


2 


4^ 


EOR 


Cr,s),y 


2 


53 


EOR 


d 


2 


45 


EOR 


d,K 


2 


55 


EOR 


r.s 


2 


^3 


EOR 


Id] 


2 


47 


EOR 


Id],y 


2 


57 


EOK 


* 


1 O!) 


49 


EOK 


a 


3 


4D 


EOR 


a„K 


3 


5D 


EOR 


a,y 


3 


59 


EOR 


3.\ 


4 


4F 


EOR 


aKx 


4 


5F 


INC 


Ace 


1 


lA 


INC 


d 


z 


E6 


INC 


d,x 


2 


F6 


INC 


a 


3 


EE 


INC 


a,x 


3 


FE 


INX 


i 


I 


E8 


I>rY 


I 


1 


C8 


JML 


(3) 


3 


DC 


JMP 


Ca) 


3 


6C 


J MP 


Ca,x) 


3 


7C 


JMP 


a 


3 


4C 


JMP 


a[ 


4 


5C 









Opcod* 




Nam« 


Mode 


Byl*i 


numbar 




JSL 


a] 


4 


22 




JSR 


Ca,x5 


3 


FC 




JSR 


a 


3 


20 




LDA 


td) 


2 


B2 




IDA 


Cd),y 


2 


Bl 




LDA 


Cd,x) 


2 


Al 




LDA 


Cf,s),7 


2 


B3 




LDA 


d 


2 


AS 




LDA 


d,x 


2 


B5 




LDA 


r.s 


2 


A3 




LDA 


[dl 


2 


A7 




LDA 


[d],y 


2 


137 




LDA 


# 


2 6) 


A9 




LDA 


a 


3 


AD 




LDA 


a,x 


3 


BD 




LDA 


a-y 


3 


w 


■■' ■* 


LDA 


al 


4 


AF 




LDA 


al,jE 


4 


BF 




LDX 


d 


2 


A6 




LDX 


d,y 


2 


B6 




LDX 


# 


2 C3) 


A2 




LDX 


a 


3 


AE 




LDX 


ShY 


3 


BE 




LDY 


d 


2 


A4 




LD¥ 


d,x 


2 


B4 




LDY 


#■ 


2 G) 


AO 




LDY 


a 


3 


AC 




LDY 


a, I 


3 


DC 


■ 1 


LSR 


Ace 


1 


4A 




LSR 


d 


2 


46 




LSR 


d,x 


2 


56 




LSR 


3 


3 


<1E 




LSR 


a^K 


3 


5E 




MVN 


Kya 


3 


54 




MVP 


xya 


3 


44 





NOP 



EA 
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Opcroda 








Opcotfe 




HOTfM 


ModB 


B/tes 


numbsr 


Nam« 


Mode 


Bylsi 


number 




ORA 


Cd> 


2 


12 


ROR 


Act 


1 


6A 




ORA 


Cd).y 


2 


11 


KOR 


d 


2 


66 




ORA 


Cd,x3 


I 


□ 1 


KOR 


d.x 


2 


76 




ORA 


Cr.5),y 


2 


13 


ROR 


a 


3 


6£ 




OKA 


d 


2 


05 


ROR 


i,x 


3 


7E 




ORA 


d,x 


2 


15 


fill 


s 


1 


40 




ORA 


r.s 


2 


03 












OllA 


[d] 


2 


07 


RTS 


s 

s 


1 
1 


6B 
60 




QRA 


[d],y 


2 


17 












ORA 


# 


2 6) 


09 


SBC 


Cd) 


2 


F2 




ORA 


a 


3 


OD 


SBC 


Cd),y 


2 


F2 




ORA 


a,x 


3 


ID 


SBC 


(d,x) 


2 


El 




OR.4i 


a.J- 


3 


19 


SBC 


Cr,s),y 


2 


F3 




ORA 


^1 


4 


OF 


SBC 


d 


2 


E5 




OflA 


* ^'^'^'^ 


4 


IF 


SBC 


d.x 


2 


F5 




PEA 




3 


¥4 


SBC 


f.s 


2 


E3 1; 




PEI 


s 


2 


D4 


SBC 


[d] 


2 


E7 ;i 




PER 


s 


3 


62 


SBC 
SBC 


[d],y 


2 
2 6) 


F7 
E9 




PHA 


s 




4B 












PHB 


s 




as 


SBC 
SBC 


a 


3 
3 


FD 




PHD 


5 




OB 












PMK 


s 




4B 


SBC 

sue 


al 


3 
4 


F9 ! 
IF 




PHP 
PIIX 


s 




08 
DA 


SBC 


a],x 


4 


FF 




PHY 


s 




5A 


SEC 


i 


1 


38 




PLA 


s 




68 


SEP 

SEI 


' 


1 
1 


FB 
7B 




PLU 


s 




AB 


SEP 


* 


2 


E2 




1 PLD 
PLP 


s 




2B 












^ 




28 


STA 


Cd) 


2 


92 




PLX 


s 




1-A 


STA 


Cd),y 


2 


91 




PLY 


s 




7A 


STA 


Cd.x) 


2 


81 ' 




REP 


# 




C2 


STA 
STA 


d 


2 

2 


93 
85 




ROL 


Ace 




2A 


STA 


d,x 


2 


95 




ROL 


d 




26 


STA 


r,s 


2 


S3 




ROL 


d,x 


2 


36 


STA 


Idl 


2 


S7 f 




HOL 


a 


3 


2E 


STA 


Idf.v 


2 


97 : 




HUL 


a.x 


3 


3E 


Sl'A 

STA 


3,X 


3 
3 


8D 
9D 












STA 


a,y 


3 


99 






-',>-, 
t ' 






S'l'A 


al 


4 


SF 












STA 
STP 


1 


1 


DE 












ApBttidlsf: ^Imm 


mb]§r/!^ln!-ft^§mfeh 


.1 

i 
,1 




^^^^^^^1 


^^^^^^^H 


^^^^^H 


^^^^^^^H 




^^^^^^^^1 


^^^^^^H 













□pcoda 


Nam« 


Mod« 


Bylei 


numbar 


bTX 


d 


2 


66 


srx 


d,Y 


2 


96 


5TX 


A 


3 


8E 


STY 


d 


2 


S4 


snr 


d,x 


2 


94 


STY 


a 


3 


8C 


ST£ 


d 


2 


64 


5T2 


d,x 


2 


74 


STZ 


a 


3 


9C 


5T7. 


a,x 




9E 


TAX 


i 




AA 


lAY 


t 




A8 


TCD 


I 




5B 


TCS 


I 




IB 


TDC 


i 




7B 
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Appendix G 



The Control Panel 



The Control Panel firmware allows you to experinienr with differeni sysiem 
conrigurations and ctiange the syslem lime. You can also permnanenily store any 
changes in the bauery-powered RAM (cailed Batiery Jl^,\h. The Battery RAM is a 
Macintosh dock chip ihai has 256 bytes of battery-powered RAM for sysiem- 
para meter storage. 

Tliti Conirol Panel proj^ram is a ROM-re^idcni hardware conTguralion program. It is 
invoiced when the system is powered up if you press ihc OpUoa key, An allemaLe tneans 
□f invokinE The Canuol Panel is to perfofiti a cold start by pressing Control and Lhe 
Option key at Lhc same lime and then Ueset. The Desk Manager can also call the 
Control Panel and affect the values specified in Lhis appendix. 



Control Panel parameters 

The folJowing ire the selections and options available Tor each ConUol Panel menu. A 
checkmark (V) indicates lhe default value far each option. 
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■sa! 



pr 



^fsm 



Printer port 

Sets up aU reUled functions for ihe printer port (sIot IX Options are as fallows: 



OpNon 

Device connect 

Line length 



Echo 

BufTering 
Baud 



Choices 

V Printer 
Modem 

V Unlimited 

40 
72 

SO 

132 



Delete first LF after CR V No 

Yes 

Add LF after CR 



V Yes 
No 

V No 
Yes 

V No 
Yes 



50 

75 

no 

1345 

150 

300 

eso 

1200 



2400 

3600 
4800 

7300 

V 9600 
19,200 



OpMon 




Choices 


Data bits 


V 


a 

7 
6 
5 


Scop b{is 


V 


2 
1 


Parity 


V 


Odd 

Even 
None 


DCD handshake 


< 


Yes 

No 


DSR/DTR handshake 


-^ 


Yes 

No 


XON/XOFF handshake 


s/ 


Yes 
No 
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Modem port 

Sei& up all related lunctions for the modem port (slot 2>. Options are as follows: 



Opri&n 




Cholcai 


Option 


CPwIcn 


Device coiuiected 


^f 


Modem 
Printer 


Daca bits 


7 


line length 


^/ 


Unlimited 

40 




6 
5 






72 


Stop bits 


V2 






80. 




1 






132 


Parity 


Odd 


Deteie first LF after CR 


V 


No 
Yes 




Even 
V None 


Add LF after CE 


^ 


Yes 
No 


TXID handshake 


No 

^' Yes 


Echo 


V 


No 
Yes 


DSR/DTH handshake 


^/ Yes 

No 


Buffering 


V 


No 
Yes 


XON/XOFF handshake 


Yes 
V No 


Baud 


V 


50 

75 
110 

150 
300 

60Q 
12O0 
1800 
24O0 
3600 
^SOQ 
7200 
19.200 
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^ 



Pisptay 



Selects all video-spedfic oplions. Choosing Type automaLically causes color or 
monochrome selections lo appear on the rest of ihe screen. Options are as follows; 

Type "i Color 



Columns 



Hertz 



Mono 

■J 40 

SO 

^ 60 
50 



monochronrw 

oplions 

Text 

color 



Text 

background 



Choices 

(.Color name is displayed^ 



Black 
D3i.rk blue 
Purple 

Dark green 
Dark gray 
Medium blue 
Liglit blue 
Brown 



Orange 
Light gray 

Pink 
Light green 
Yellow 
Aquamarine 
^ White 



(Color name is displayed^ 



Black 
Deep red 

Dafk blue 
Purple 
Dark green 
Dark Rray 
V Medium blue 
Lighl blue 



Browrn 

Orange 

light gray 

Pink 

Ijghi green 

Yellow 

Aquamarine 

While 



Color/ 

monechrome 
op II on t 

Border 

■color 



Standard 
colors 



Choices 

iCoior name 

Black 
Deep red 

IDark blue 
Purple 
Dark green 
Dark gray 
"V Medium blue 
Lighi blue 

■J Yes 



di'yplayed.') 

Brown 
Orange 

Light gray 
Pink 

Ught green 
Yellow 

Aquamarine 
White 



The Ssandard colors option indicates whether 

your chosen colore match ihe Apple .Standard 
values. If you select Yes, the current colors are 
switched to Apple standard colors. 
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Sound 

AI1DW3 system volume and pitch to be altcned via an indicaior bar. The default value is 
in the middle of each range. 



Speed 

Mows dtifaLk system Speed of either normal speed (1 MHz^ or fast speeds (Z.6/2_8 
BAM,''H0M MHz). Available aptigns are as foUows: 

Dpi Ian Choicvi 

I System speed V Fast 

Normal 



RAM dF£k 

Allows default amount of free RAM lo be used for RAM disk Option.'; aje as foClowS: 

Minimum Tree RAM for RAM disk: Cminimum) 
Maximum free RAM for RAM dj'sk; (maximum) 

Graduations between minimum and maximum are determined by adding or 
subtracting 32K from the RAM size that es displayed. Limited lo zero or the Sargesl 
sel*;ciablc sipie. Default RAiM disk size is hyles minimum, bytes maxlmjm RAM disk 
size ranges from D byies m largest selectable RAM disk size. 



TKc amount df ^ee RAH fiii kilobytes) for the SAM tli$k Ls displayed on, the scieen in 
the format xxkxkK. Ffcc RAM equaU ihe total system RAM minus 256K 

The current RAM disk size is atso displayed on ihe screen. The current RAM disk size 
can be determined by one of the RAM disk driver commands. 

The foOowtng mes-sa^ will be displayed on the screen: 

Total RfiM in use: scxxxxK 

Total RAM in use equals toial system RAM minus lotaJ free RAM. 

The total Free RAM disk space will be displayed on the screen. You can determine the 
amount of IDtaJ free RAM by calling the Memory Manager, 
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Slofs 



Allows you to select either built in device of peripheral card for skJL^ 1^ 2, 3, 4. 5, 6. 
and 7. M$o allows you to selecL startup slot or lo scan slots ai sfartup lime. Options 
ava^ilable are as follows: 



Option ChQtc« 

Slot 1 -J Printer port 

Your card 

Slot 2 V Modem port 

Your card 

Slat 3 V Bulk- in ttxi display 

Your cifd 

Slot 4 V Mouse port 

Ydur card 

Slot 5 V SmariHori 

Yauf card 

Slot 6 V Disk port 

YOiir card 



OpHon 

Slot? 

Startup £lcii 



Choices 

Bui It- in AppleTalk 

V Your card 

V Scan 
I 

2 

3 
4 
5 

6 

7 

RAM d[sk 

ROM Uiik 



Options 

Allows you lo select the keyboard layoui, text display language, key rc[xrat speed, and 
delay to key repeat to use advanced features. Layouts and languages are dLSplaytid that 
correspond to ihe hardware. UyouLs and languages ryi available wiih your hardware 
Ckeyboard micro and Mega II) are not displayed. 'ITie inAjrmation about ttic kyout5 
and languages that are available comes from ihe keyboard ntitru at power up tmie. 
Opdons are a* follows: 



Opllon 


Choices 


OpMon 


Choices 


Display 


Chosen from Table G-1 


Repeat 


4 char/sec 


language 




.s^Kred 


8 charAcc 


Keyboard 


Chosen from Table C-1 




11 char/sec 


layout 






15 char/sec 
V 20 char/sec 


Keyboard 


Vno 




24 char/sec 


buffering 


Yes 




50 char/sec 
40 Lhar/sec 






Repeat 


.25 set: 






delay 


.50 sec 
■J ,75 sec 
1.00 sec 
No repeat 
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DpMon 




Cholc6» 


Advanced features 




Double -dick 


1 tick = l/60 sec 


Shift caps/ -J No 




time 




50 ticks Cslow) 
40u'.cks 
V 30 ticks 
20[icks 
10 ticks crasO 


lowercase Yes 

Fast space/ V No 
delete keys Yes 

Dual speed V Normal 
heys Fast 




Cui^Or 


Hash 


1 tick = 1/60 sec 


High-speed ^^ No 




rate 




ticks (cQ Hash) 
60 licks 
V 30 licks 
15EiCk5 
10 licks (fast) 


mouse Yes 




Tabl9G-1 








iLangyage options 








hiumbfii 


ASCII 


Numbsr 


ASCII 





English CU S.AJ 10 


Finnish 


] 


Fngiish (U.K.) 11 


Portuguese 




2 


French 


12 


Tamil 


' 


3 


Danish 


13 


Hindi 


1 


4 


Spanish 


14 


Tl 




5 


Italian 


15 


TZ 




6 


German 


16 


T3 




7 


Swedish 


17 


T4 




e 


Dvorak 


IS 


T5 


1 


9 


French Canadian 19' 


T^ 




A 


Flemish 


lA 


U 




B 


Hebrew 


m 


L2 




c 


Japanese 


IC 


13 




D 


Arabic 


ID 


L4 


1 


E 


Greek 


IF- 


L5 


i 


F 


Turkish 


ir 


l6 


1 


For Ihe 


language options, itenu 0-7 are av3.ilable to CDntrol ihe display language. 




Items 8 


and 9 convrol ihe keyboard layout. 




' 


Clhe ke>i>oard microprocessor provides the 


pointer for ilie appropriate ASCII value 




listed in Table G-1.) 
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Clock 

ALows you [o sei the lime and dale and tinrte/date fdrmats. Qpiioris are as foUowS; 



OpMon 


Choices 


Option 


Choices 


Month 


1-12 


Hour 


1-12 or 0-23 


Day 


1-33 




(depends on 






Format selected^ 


Year 


19(^1-2044 










Minute 


0-59 


Format 


V MM/nn/YY 








DD/MM/YY 


Second 


0-59 




YY/MM/DD 


Format 


V AM-PM 
24-houf 



Quit 

Returns to calling application or, if called from keyboard, performs a startup hjnetion. 



Battery-powered RAM 

The BaEtery RAM is a Macintysh dtsck chip ihat has 256 bytes of ballery-powered RAM 
used for system-pafanictcr storage The AppleTalk node number is slored in Lhe 
Battery RAiM^ se: by the AppleTalk firmwafe. 

♦ Note: The Battery RAM is not for appllcaxion program use. 

The Ba[ter>' RAM must Include encoded bytes for all options that can be selected from 
the ConLro] Panel, Standard setup values are placed into Battery RAM during 
manufacturing However, the keyboard layout and displ,a.y language are deteniuiied by 
the keyboard used. 

Itcnis that can be changed by tnanufacruring and the Control Panel program can al^o 

be changed by your application program; however, only the Miscellaneous Tool Set 
Battery RAM rouiineii or another Apple-approved utility program can make changes 
lo Eaitery KAM, ]f the changing program is not an Apple-approved utility, Battery 
RAiM will be severely damaged and the system will become inope/ativp_ IF Bauery RAM 
is damaged and inopetative Cor the battery dies), tiie Tirmware will automatically use 
the App!e standard values to bring up the system. The battery can be replaced, and 
you can enter the Control Panel program lo restore the system to Its prior 
Configuration. 
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Control Panel at power-up 

At power-up, Ihe Batteiy HA.M is ciiecksummed, If the Battery RAM faik iLs diecksum 
test, ihe system assumes a U.S. keyhoard ain/iguraUon and English language. Further, 
U.S. standard pafamcters; are cliecksummed and moved to the BatlCry RAM storage 
buffer in bank SEl. "ITie system continues miming using U.S. standard parameters. 



Control Panel at power-LfD 307 




jjJUAwyMJum i i^^^LJjJLiawy^Aja^^ 




Appendix H 



Banks $E0 and $E1 



A special jwctlon of Apple HGS memory is dedicated lo the Mega If chip. The Mega II, 
also called the Appfe-]E-on-a-chip, 15 a separate coprocessor ihat nans at ] MH2 and 
provLdcs [be display ihaL ihe Apple UGS produces on the video screen. 

To communicate with Lhe Megs. II, the Apple IIGS either writes direcay into bank $E0 
or $E1 or enables a special soft switch, named shadowing. When shadnwing js 
enabled, whenever ihe Apple HGS writes into bank 500 (of bifik $01), the sySLem 
auLonraacically synchioni^es with the Mega El and wriKS the same data into bank $E0 (nr 
bank iEl). 

Figure H-1 depicts the layout of the memory in these hanks of memory, Some of this 
inemor>^ is dedicated to display areas, some of it is resen-ed for flrmwatc use. and 
some of U is declared as free space ajid is managed by the Memory Manager. 

Figijre H-l shows the location of the various functions of Apple IlGS banks SEO and 
SE]. In the figure, the notation /T means a decimal value of 1024 bytes, and the 
notation page means hex 3100 bytes. 

'^ Note: In Figure H-l, the memory segments tilled /?w Space are available through 
the Memory Manager onJy, 



30B 



5E0 main language cord 
920 gogea 



Bonk 500 
5 ID pages 
(4K reserved) 



Bank 501 

$10 pages 

C4K reserved; 



I/O (always actJh/ej 



$60 poQea 

(2JK ti^s i^QceJ 



Ooubia Hi-r?es page two 
(SdD00-S5FFF> 

Graphics 



Double Hi'fiei poge ond 
(5200a-53FFF> 

Sraphici 



S14 Dages 
[SK reserved) 



Teirt Poge 2 



Tew Page 



M pa QBE 

(1 K reservedj 



Figure HI 

Memory map of banks $E0 and SEl 



SFFFF 



SEOOQ 



— SDOOa 



■SCOOQ' 
•SAODO- 
'S8000- 
■S700D- 



■ S5000 ■ 

■ $4oao ' 

■ S3000 - 
■ S 2000 ■ 

■socoo- 
soaoo- 

■ $0400 - 

soDao - 



SE 1 aux ranauoge ccrd 
(SK ra^erved} 



Bonk SOO 
S 10 pages 
C4K reserved) 



Bank SOI 
$10 pagan 
(4K reserved) 



I/O (aiwoys active) 



£20 pages 

C8K free ^pace) 



Super H|-Res 
CSfiaOO-S9fFF) 

Graphics 



DoubJe Hl-Ues page rwo 
{S^aOO-SSFFF) 

Graphites 



DouibfB Hl-I?es page one 
tS2QDD-S3fFF) 

Graphiet 



S34 pages 
fSK reserved] 

Terr Page 2 



Text Page 1 



54 pages 
(K resorv^aj 
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Using banks SEO and $E1 



You can use graphics memofy located in mettiory banks 5E0 and SEl or ihe Tree space 

vfa ihe Memojy iManager; however, you must exercise cauLion to ensure that you don't 
use areas ihal axe reserved for machine use, 



Free space 

Eighty hexadecimal pages, or 52K byies, in the area labeled /reejpflcecin be used) 
however, this area must be accessed ihrough [he Memory Manager. G"he Memory 
Manager can be caJed Lhrough ihe Apple HGS Toolbox ;) If you Liy lo use Lhis ^pacc 
without Hrst calling [he Memory Maniger, you will cause a system failure^ 

Video buJTefS noi needed for screen display may be used for your applications. 

■* Note.' Video buffers are used by firmware only for video display^ Liccause there ts no 
way to determine which video modes are needed by your applications. 



Language-card area 

The language-card area is switched by the same sofl switches used to switch Apple II 
simulaUon language cards in banks $00 and SOI. Before switching language-card banks 
Cor ROM for RAM or RAM for ROM), the current configuration muSl be saved The 
CQnljguraiian must be restored after your subtoucine is finished accessing the switched 
area, 



Shadowing 

The shadowing ability of the Apple IIGS can be used by applications tO' display overlay 
data on the screen. Normally, if an application wa nis lo display an overlay on an 
existing screen, it must save ihe data in the area that is overwritten. Because of the 
i^lodciWLng capabilities of the Apple IIGS, lhis task is simplified. 

When shadowing is turned on, ycu draw your original screen display into banks SOD 
and SOI, To display the overlay, turn shadowing off and write dircctJy into banks JEO 
and SCI. This affecis only ihe display and not the original screen data that is also 
present in banks $00 and SOI, When you are finished with the oveday, enable 
shadowing again and simply read and write the screen data (use M^TS' or MVP for 
speed) into the current screen area using banks SOO and 401. This wil have no tfTcct on 
banks 500 or $01, but ii will restore ihe display lo its appearance before the overlay 
data was written. 
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accmnu^or; ITie rcgfsier In a computer's central 
processor or micraprncessor where mosi 
COmputatiOfl^ are performed. 

ACIAe Abbreviation for Asynchronous 
Communications Interface Ad&fiter, a type of 

communicaUans iC used in some Apple 
computers. An ACTA convert? daia from parallel 
lo serial form and vice versa. It handles serial 
irausmission aii<l recepEiDii and RS-Z3Z-C signals 
yndcf the control nf i[5 internal registers, which 
can be set arsd changed by firmware or software. 
Compare sec. 

ADO: See Apple DeskTop Bus. 

address: A number that specifies ihe location pf a 
single byle of memory. Addresses can be given as 
dedmal or hexadecimal integers. The Apple TIGS 
has addresses raging from g to 16.777,215 
(decimal) or from JOO 00 00 to SFF FF FF 
ChexadecimaO. A complete address consists of a 
4'bit bank number C$00 to %m foUowed by a \6- 
bit address witfiin that bank ($00 00 to SFF FF), 

Apple DeskTop Bus (ADB); A low-spfied serial 
input port thai supports Ihe keyboard, the ADB 

mouse, and additional input devices, such as hand 
controls and graphics tablets, 

Apple key^ A modifier key on the Apple LIGS 
keyboard, marked with boih an Apple icon and a 
spinner, the icon used on the equivalent key on 
some Macintosh keyboards. It performs the same 
functions as the ci key on standard Apple II 
cornputers. 



AppleTaik: Apple's local-area network for 
Apple II and Macintosh personal computers and 

the LaserWriter and ImageWriier II printers, Like 
the Macintcjsh, the Apple JJGS has the AppleTalk 
interface built in. 

AppleTalk connector: A piece of equipment 

consisting of a connection box, a short cabJe, and 
an 8-pin miniature DIN connector thai enables an 
Apple JIGS to be part of an AppleTalk network. 

Apple n: A family of computera, including the 
origuial Apple U, the Apple II Plus, die Apple ne^ 
the Apple Ik, and the Apple Qcs. Compare 
standard Apple ll, 

Apple Iios Programmer's Workshop CAPW^ 
ThG development environn^cni for the Apple IIGS 
computer. U consists of a set of progrgrns that 
facilitate the writing, compiling, and debugging of 
Apple IIGS apphcations. 

APW: See Apple IIGS Programmer's 
Wojrksbop. 

assewibler: A program that produces object 

files (progfanis ihat contain machine-la_nguage 
code) from source flics written in assembly 
language. The opposite of disa.ss«iabler. 

background prhiilng: Printing from one 

application while anodier application is running. 

bank; A 64K (65,536-bytG3 portion of the 
Apple IIGS internal memory. An indiuidual bank Is 
specified by (he value of one of the 65CS16 
microprocessor's bank registers. 
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banJt-$witclied meniory: On Apple II 
computers, that part of (he lamguage^card 
memory En which two 4K portions of memoiv 
share the same addiess range tSDOOQ lo SDrhR. 

BASiCOUT: The routine that putpuls & characler 
when ihe 8Q-column firmware Ls active. 

Battery RAM: SAM memory on iKc Apple IlGS 
deck chip, A bauery preserves ihe clock settings 
and the RAM contents when the power 15 off. 
Control Panel seilinjjs are kept in the Battery RAM. 

baud i^te: The rate aE which seriaJ data is 
transferred, measured in signal iransiiions per 
second. It takes approximately 10 signal 
transilions to transmit 3 single character, 

bit A contraciinn of binary digit. The smallest 
unit of infomiaiion a computer ean hold The 
value of a bit <l or 0) represents a simple two-'tray 
choice^ such as on or off, 

block: (1) A unit of data storage or transfer, 

typically 512 bytes. (2) A contiguous, page-aligned 
region of cojmp^Jitet memory qf arbitrary size, 
allocated by the Memory Manager. Also called a 

merriGry block. 

block deiflce: A device thai uansfers data 10 oc 
ffom a computer in multiples of one block C512 
bytes3 of characters at a time. Disk drives are block 
devices. Also called b/oc* I/O device^ 

boot; Another way to say start up. A computer 
boots by loading a program into memory from an 
ejrternal storage medium such as a disk. The word 
boot is short for boatsirap ioad Slatting up is 
often accomplished by first loading a small 
program, which then reads a larger program into 
memory. The program is iSaid Lo "pull itself up by 
its own bootstraps.' 

buffer; A holding area in the computer's memory 
(for e:rample, a prim buffer) where information 
can l>e stored by one program or device and then 
read at a different rate by another. 



byte: A unit of information consisting of a 

sequence of 8 bits. A luyte can take any value 
between and 255 ($0 and $FF hexadecimal). The 
vatue can represent an inslnjctlon, a number, a 
character, or a logical state. 

carry flagi A status bit in the inicnj processor, 
used as an additional high-order bit with the 
accumulator bits in addition, subiraciion, 
rotation, and shift operations. 

central processlne i^^t (CPIT); The part of the 

computer that performs the actual computaiJons 
in machine knguage. See also microproccssar. 

character; Any symbol that has a widely 
understood meaning and thus can convey 
information. Some charaetens, such as Hellers, 
numbera, and punctuation, can be displayed on 
the monitor screen and primed on a prtniier. Most 
characters are represented in the cornputer as 1- 
byte values- 
damp! A memory location that contains the 
maximum and minimum excursion posiUons of 
the mouse cursor when the desktop is in use. 

CMOS; Acronym for comptementary metal oxide 
semiconductor, one of several methods of making 

integrated circuits out of silicon. OMOS devices 
are characterised by Eow power consumption. 

controller card: A peripheral card that connects 
a device such as a printer or disk drive to a 
computer's main logic board and controls the 
operation of the device. 

Coatfol Panel: A desk accessory that lei5 the 
user change certain system parameters, such as 

speaker volume, display colorSp and configuration 
of slo^s and ports. 

control register: A special register that programs 
can read and write, similar to a soft snitcli- The 
control registers arc specific locations in the I/O 
space C$C)Ofx} tn bank SEO, they are acce^ible 
from bank SOO if I/O shadowing is on. 



i 



312 



Glossary 



Conlrol-Rcset; A comblnaiion keystroke on 
Apple If compjEers that u.sually causes an 
Applesoft BASIC prograim or command to stop 
immedialely. 

COUT: The firmware entry point for ihc Apple II 
charactcr-uTJipnji subroudnc. COUT is actually an 
T/O link located in BAM rather Lhan in ROM, and 
so ca.n be modified to conUin ihe address of the 
presently active charactcr-ouipul subroutine. 

COLTTl: An eniry point within [he Apple II 

character-output subrputine. 

C3COUT1: Also called BASICOUT, this is the 
routine Lhai COUT jumps to when the &D-column 
firmware is active. 

data: Information Lransferred lo or from, or 
stored in, a compu[er or oLher mechanical 
communications or storage device, 

DCD: Abbreviation For Data Carrier Detect^ a 
modem stf^nal indtcaiing that a corrnnunicaUon 
connection has been estabtifihed. 

Delete key: A key on the upper-right comer of 
the Apple Ec, Apple lie, and Apple IIGS 
keyboards that cra-ses the character immediately 
preceding (to the left oO ihe cursor. Similar to the 
iVjacinioEh Backspace key. 

delta; The diiTeirence from somelhing the 
program already knows. For example, mouse 
moves ate represented ajs dtjlcas compared IQ 
previous mouse Igcalions. The name comes from 
the way malhematidam use the Greek leuer delta 
Cd) to repre'woi a difTerence. 

dfflik accessory; A small, special purpose 
program available to the user regardless of which 
application is running The Contra! Panel is an 
example oFa des.k accessory. 

desktop; The visual interface between the 
computer and the user — the menu bar and the gray 
affia on the screen. 



devIcK A piece of hardware used in conjunction 

w/ith a computer and under the computer's 
conirol. Also called a fieripheral device heCAVse 
such equipment is often phyi^icaliy separate from 

Cbut atuched to) ihe computer. 

device driver: A program that manage,«i the 

uan.sfer nf information between the computer and 
a peripheral device. 

Digital Osfilllator Chip (Dt>C> An integrated 

Circuit in the Apple lies that contains 32 digital 
Dscillatdrs, each of which can generate a sound 
from stored digi^l waveform data. 

DIN: Acronym for Deutsche Industrie Normal a 
European standards organization. 

DIN connector; A type of connector with 
multiple pins inside a rtjund outer shield. 

direct page: A page (256 bytes) of bank SOO of 
Apple IIGS memory, any pan of which can be 
addrt^^ed with a short Cl byte) address because its 

ht;^-ordef byte of the address is always SOfl 3rd its 

middle byte of the address is the value of the 
65C8I6 direct regi«iter. Coresident programs or 

routines can have their own direct pages at 
different kications, The direct page corcespond& 
10 (he 6602 processor's zero page. The lerni direa 
page is often used informally to refer to any pan of 
the lower poition of the direct -page/stack space. 

direct-pageystadt space: A portion of bank $00 

of Apple IIGS memory reserved for a program's 
direct page arid stack. Irttially, the 65CS16 
processor's direct regjster contains ihe base 
address of the space, and its stack reglscer 
contains the highest address. Tn use, the stack 
grows downward from the top of the direct- 
page/stack space, and the lower part of the space 
contains direct-page data. 

direct register: A hardware register in the 65Cei6 
processor that specifics the start of the direct page. 
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disassembler: A program that examines data in 
memory and interprets it as a sel of a-S^ennbi^- 
Imguage insiruciions. Assuming the daia is objea 
code, 3l disasscmbJer gives Ehe user ihe source 
code diat could have generaccd tliat oblcci code. 

disk operating System: An Dperaiing system 
whose principal funcLion is lo manage Tiles and 

communicaiion wiih one or more disk drives. 
DOS and ProDOS are two families of Apple M dbk 
operating systems. 

Disk H df ivft A type or di&k drive made and sold 
by Apple Computer for use with the Apple n, 
Apple U Plus, and Apple He computers. It uses 
5.25-iiich dlsks- 

DOC: See Digital OsdllatOr Chip. 

DOS; An AppJe 11 disk operating syseeoi. Acronym 
Tof Disk Operaiing System. 

Double Hi-Res: A high-resolution graphics 
display made on Apple 11 tijmpiuLiers with al least 
128K of RAM, consisting of an array of points 5^0 
wide by 192 high wiih 16 cobis 

DSRs Abbreviation For Data Set Ready, a signal 
indicating that a modem has established a 
connection. 

DTRi Abbreviation for Data Terminal Ready, a 
5Jgna] indicating that a terminal is n^ady 10 
transmil or receive data. 

c fla«; One of ihrct: flag bits in the 65CS16 
processor that programs use to control the 
processor's operating modes. The seiline of the e 
Hag dcL'^nTiints whether tJie processor is In native 
mode or emuladon mode. See also m flag and 

S-blt Apple n$ Another way of s^a,ying standard 
Apple Hj ii-]ii is, any Apptc II with an fl-bit 
microprocessor CS5^2 or 65C02). 

80-calunui teiti card: A peripheral card that 
allows the Apple II, Apple U Plus^ and Apple lie 
computers to display text in 30 columns (in 
addition uj the standard AQ columns). 



emulate: To operate in a way identical to a 
differem sysiem For ejtample, the 65'CSl6 

microprocessor in the Apple IIGS can carry oui all 
the instructions irt a program originally written for 
an Apple II that uics a 6502 microproceBSor, thus 
emiJ luting the 6502. 

emulation modei Tlie S-bit configuration pf the 

65C816 priMiessor in which the processor functions 
like a 6502 processor in all respects except clod: 
speed. 

environment! The complete set of macliine 
registers associated with a running program. 
Saving the environment allows a program 10 be 
restored to its original operating mode with all of 
its register? Intaa a^ though nothing had 
happened. Saving and restoring an environment 
is most often associated with calling system 
functions or processing inlertupis. 

erron The state of a computer after it has detected 
a fault in one or more commands sent to it Also 
called error condltlonu 

escape code: A key setjuence fonned by pte&sing 
the Esc (Escape) key, followed tay pressing another 
key Escape ccxles arc used to control the video 
firmware. 

^cape mode: The mode of video-firmware 

operation activated by pressing the Esc (Escape^ 
key. It allows for moving the cursor, picking up 
characiTLTS from the screen, and performing oliicr 
special operations. 

extended SmartPort call: A SmantPon, call that 
alSows data transfer \o or from anywhere in Che 
App!e llGS system memory space. Compare 
standard SiDarlFort c^L 

field: A string of ASCII charaaers or a value that 
hiis a specific meaning Id some program. Fields 
may be of Ptxed Eengih or may be sepai^ated from 
other fields by field delimiters. For example, each 
parameter In a segment header constitutes a field. 
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nroiware: Programs stored permancndy in 
ROM; mosL provide an inierFace lo system 
hirdware. Such programs (for exampJe, [he 
Monitor program) are built into the compuier aL 
the faaory. "Vhey can be executed at any time, but 
cannot be modified or erased from main 
memory. 

format: (n) The form in which infonnalion is 
organized or presenied. Cv) To divide a disk inlo 
tracks and sectors where information can be 
stored- synonymous with Initialize. Blank disks 
must be fornisttcd before ihe user can save 
information on them for the Hrsi lime. 

frequencyji The rate at which a repetitive event 
recurs, fn alternating current <AO signals, [he 
Tiumber of cydes per second. Freqtiency is usuaUy 
eirpressed in herts (tycles per second), 
kilohcrtz, or meg^ertz, 

GETLNi The firmware routine thai 3 program calls 
lo obuin an entire line of characters from ihe 
currenliy active input device. 

GLUi Acronym for gensrai iogic unit, a class of 

custom inECgraied circuits used a-S. inied^ces. 
between different parts of xhe computer, 

handshaking: The exchange of Status 
inrormauon between two data lerminats used lo 
control the transfer of data between them. The 
siattis information can bo the slate of a signal 
connecting the two terminals, or it can be in the 
form of a character trarLgmitted with the resi of the 
data. 

hertz (Hz): Tlje uryt of frequency oF vibration or 
Oscillation, defined as the number of cycles per 
second. Named for the physicist tleinrich Hertz. 
See also kllohcrtz and megahertz. 



bexadedmal: The base-l6 system of numbers, 
ustng the ten digits through 9 and Ihe six letters A 
through F. Hexadecimal numbcis r_an be 
converted easily and directly to binary form, 
becau&e each hexadecimal digit corresponds to a 
sequence of 4 bits. In Apple maniiaJs, 
hexadedmai numbers are usually preceded by a 
dollar sign CO. 

hJgli order; The most significant part of a 
numerical quantity. In normal representation, tlic 
high'Order bit of a binary value is in the lel^ost 
position, likewise;, the high-order byte of a binary 
word or lon^word quantity consists of the 
leftmost S bits, 

Hl-Res: A high- resolution graphics display mode 
on the Apple U family of corfiputers, consisting of 
an array of points 280 wide by 1P2 high with 6 
colors. 

Human interface Cutdetlnesi A set of software 

developmen! guidelines designed by Apple 
Computer [o support the desktop concept and lo 
promote uniform user interfaoes in Apple H and 
Macintosh applications. 

icon: An image thai graphically ropresenls an 
ol3JecT, a concept, or a message, 

Index regL«iLer! A register in a computer 
proce&sot that holds an index for use in indexed 
addressing. The 6502 and 65C^\6 
microprocessors ysod in [he Apple U family of 
computers have two index rGgisiers, called the X 
register and the Y register. 

inJciallze: See forntat (v>. 

Incelligent device: A device containing a 

rmcroprocessof and a program that allows the 
device to interpret data sent to k as commands 
that the device is lo perform. 

Interpreter: A program that interprets its source 
files on a statement-by-sLatemeni or character- 
by-character basis. 
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Interrupt handlef: A program, associated with a 
paiticular external device, chat exeoiies whenever 
that device sends an interrupt signal to the 
compuier. The intermpi handlef performs its tasks 
during the inlerrupL, [hen returns conirol lo the 
computer so It ma,y resume program execution, 

IRQ: A 65CS16 signal line that, when activated, 
cau^S an interrupt request to be generated. 

IWM: Abbreviation fof fntegrated l^oi Machine. 
the custom chip used in built-in disk ports on 
Appie computers. 

KEYTN: The firmware entry point that a program 
calls to obtain a keysuoke from the currently active 
input device (nonnally the keyboard), 

kUobib A unit of measiifemenl^ lOZ^ bits, 
conuntmly used in specifying the capacity of 
memory integrated circuits. Not to be confused 
with kUobyte. 

kilobyte: A unit of measurement, 1021 bytes, 
commonly used in specifyirig the capacity of 
memory or disk storage systems. 

Idlohertz (JcHz): A unit of measui^ment of 
fitquency, equal lo 1000 benz. Compare 
Enegahertz. 

Language-card meinory: Memory with 
addrtrsscs between iDOOO and SFFTF on any 
Apple It-famiiy computer. It includes i^o RAM 
banks in the $Dxxx space, called banlt-iswltched 
fnemory. The language card was originally a 
peripheral card for the 'iSK Apple 11 or Apple IF 
Plus computer that expanded Ihe computer's 
memory capacity to 6AK and provided space for 
an additional dialect of BASIC. 

last ciiajitgeai>le location: The last location 
whofifi value the user inquired aboul through the 
Monitor. 



Unki Aji area in memory that contains an address 
and a jump instniction. Programs are wriuefi to 
jump to the link address. Other programs can 
modily this address to make everything behave 
difFerenily- COUT and KEVIN are examples of 
I/O Unks, 

loogfrord: A double- length word. For the 
Apple UGS, a long word is 32 bits (4 bytes) long. 

Lo-Resi Tlie lowest resolution j^phies display 

mode on the Apple 11 family of computers,, 
consisting of an array of blocks 48 high by -40 wide 
with l6 colors. 

low ordef; The least significani part of a 
numerical quantity. In nonnail fcpresentalion, the 
iow-ortier bU of a binary number is in the 
rightmosL position, likewise, the low-order byte of 
a binary T?ord or longwofd quantity consists of 
the rightmost 8 bits. 

me^bib A unit of measurenieni equa! to 
T,04B,576 (2^^) bit3, or 1024 kUoblts. Megabits are 
commonly used in specifying the capacity of 
memory Lntegraled circuits. Not to be confused 
with megabyte. 

megabyte: A unit of meai>"urefocnt equal to 
1,048,576 <2^*) bytes, or 1024 kilobytes. 
Megabytes are commonly used in specifying the 
capacity of memory or dLSk storage systems. 

megahertz (MHz)f A unit of measurement of 
frequency, equal to 1,000,000 htrtat. Compare 
Idlohertz. 

Mega Bs A custom large-scale Integrated circuit 
that incorporates m ml of the timing and control 
circuits of the standard Apple n. It addresses 128K 
of HAM organized as 64K main and auxiliary banks 
and provides the standard Apple 11 video display 
modes, both text C40-column and ^-column) and 
graphics (Lo Res, Hi-Res, and Double Hi-Res). 

memory btockj See block C2). 
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Memory Manager; A program in ihe Apple IIGS 
Toolbox that manages memory use. Tlie Memory 
Minager keeps tiack of how much memory is 
avaikble and allocates memory blocks Co hold 
program segments or data. 

memory mapped I/O: The method used for I/O 
Operations in Apple 11 comptiiefs. Certain 
memor>f locaiions are attached to I/O devices, 
and I/O operations are just memory load and 
store inscmctions 

m flag: One of three flag bits in the 65CS16 
processor that programs use lo control the 
processor's operating modes. In native mode, 
the setting of the m (lag determines whether the 
accumulator is S or l6 bits wide. See aLso e flag 
and X flag. 

mlcroprocrasor: A ccniral processing unit that \s 

contained in a jingle integrated circuit, The 
Apple ncs uses a 65QBI6 micropracessor. 

mlni'as§emblen A part of the Apple llGS 
Monitor program that allows the user to create 

small assembly-language test routines. See also 
assembler. 

Monitor program; A program built inio the 
firmware of Apple II computers, used for directly 
inspecting or changing the contents of main 
memory and lor operating the computer at the 
machine-language leveL 

MOSi Acronym for metal oxide semiconductor, 
one of several methods of making imegrated 
circuits. 

native mode^ The 16 bit configuration of the 
65GS16 microprocessor. 

fi|!3(t-chingeafele locntfoni The memory 

location that is next to have iis value changed. 



NTSC: (1) Abbreviation for !Vational Teievisian 
Standards Commmse. which defined the standard 
formal used for transmitting broadcast video 
signals in the United States. (2) The standard video 
format defined by the NTSC^ also called 
composite because it combines all video 
information, including color, into a single si^aL 

object file: The output from an assembler or a 
compiler, and the input to a linker. It contaias 
machine-language intnjctions_ Also called object 
program or object code. Compare source file. 

op code: See operation code. 

Gi A modifier key on some Apple II keyboards. 
On the Apple lies keyboard, the equivalent key is 
called simply the Apple key; it is marked with 
both an Apple icon and a spinner, the icon used 
on some Macintosh keyboards. 

operand: An item on which an operator (such as + 

or ANTO acts. 

operation code: Tlie part of a machine-language 
instruction thai speciJle.s the operation lo be 
performed Often called op code. 

p3Sei CD A portion of memory 256 bytes long and 
beginning at an address that is an even multiple of 
256 Memory blocks whose starting addresses are 
an even multiple of Z56 are said to be page 
aligned, C2> (usually capitalized) An area of main 
memory containing tcxi or graphic information 
being displayed on the screen 

palette; The set of colors from which the user can 
choose a color to apply to a pixel on the screen. 

paramecen A value passed to or fnam a function 
or other routine. 

paj-ameter block! A set of contiguous rrvemory 
locations sei up by 3 calling program to pa.is 
parameterii to and receive results from an 
operating-system function that the program calls. 
Every call to SmartPon must include a pointer lo a 
properly constructed parameter block. 
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parity bit: A bit O^at is someiimes transmiaed 
along wiih ihe olher bits that define a serial 
character. IE is usetl lo check the accuracy of the 
trangmi^Bion of the character. Even partly means 
ihat ihe total number yf 1 bits liansmllted, 
induding ihe parity bit itself, is even, Otskfpanty 
means that the total number is odd. 'fhc parity bit 
is generated individually for each character and 
checked, a character at a time, at the receiving 
end, 

peripheral device; &ce device. 

plxeL Short for picture efement. The smallest dnt 
that can be drawn on ihe screen. Also a location in 
video memory thai corresponds to a point on the 
jgraphtra screen when the viewing windo^v includes 
that location. In the Macintosh display, eacJi pijce] 
can be either black or white, so i[ can be 
rcpresenied by a bit^ thus, the display is said to be 
a bit map. In ilie Super Hj-Res display on the 
Apple IIGS, each pixel is represented by either 2 or 
4 bits; the display is not a bit map. but rather a 
pixel map, 

pixel inap; A set of values that represents the 
positions and states of \he set of i^els making up 
an Image. 

ProDOSi Acronym for Pw/essionai Disk 

OperatiT^ Systetn, a family of disk operating 
syslems developed for the Apple II famQy of 
computers. ProDOS includes both ProDOS ft and 
ProDOS 16. 

ProDOS 8: A disk operating system developed for 
standard Apple II ftjmputers. II nins on 650Z^ 
scries mtcroproceMons and on ihe Apple IlGS 
when Liic d5C8l6 processor is in 6502 emulatJoa 
mode. 

ProDOS 16j a disk operaung system developed 
for 65C8I6 native- mode operation on the 
Apple IIGS. It is functionally similar to FroDQS 3, 
but more pcrwerful. 



prompL A message on the screen that a program 
provides when it need.^ a response from the user. A 
prompt is usually in the form of a symbol, a dialog 
boK, or a menu of choices. 

Quagmire register: On ihe Apple ITGS, the 
name given lq the 8 bits comprising the specd- 
conlro! bit and the shadowing bits, From the 
Monitor program, rhe user can re^d from or write 
to the Quagmire i^gister to access those bits, even 
though they are actually in separate registers. 

HAMi See random access raeiaiory. 

RAM disk: A portion of RAM that appears to the 
operating ayslcm to be 3 disk volume. Files In a 
RAM disk can be accessed much faster ihan the 
same flics on a disk. See also ROM disk. 

random-acc^s memory CKAM>: Memory in 

which information can be referred to in an 
arbitrisry or random order. RAM u.>;ua!lly means 
the pan of memory available for programs from a 
diski the programs and other data are lost when 
the computer is turned off. CTechnically, the read- 
only memory Ls also randam access, and what's 
called HAM should correctly be senned read-write 
msmory.) Compare read-only meaioi*y- 

RDKEY$ The firmware routine that a. pnsgram uses 
to read a single keystroke from [he keyboard. 

fead-Only meniory CH.OM> Memory whose 
conienLs can be read, but not changed; used for 
storing Jlrmware, Information is placed into 
read-only memory once, during manufacture; it 
then remains there permanently, even when the 
computer's power is turned off, Compare 
random-access meinory. 

recharge routine; The Function thai supplies 
data to the output device when backgrotutd 
printing is taking place. 
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RGBi Abbreviation for red-green-bhte. A method 
of dLspliying color video by tiartsmiiiing ihe three 
primary colors as three separate signals. There are 
TWO ways of using RGB with COmputGiS: 771 RCB^ 
which allows ihe color signals lo take on only a few 
discrete values; and analog RGB, which allows the 
color signals to take on any values between iheir 
yppcf and lower Lmlts for a wide range of colore. 

ROM; See read-only memory* 

ROM disk: A feature of some operating systems 
that permits ifie use of ROM as a disk volume_ 
Often used for making applications permanently 
reside ni, See also RAM disl/u 

R5-2J2; A common slandard for serial dala 
commuiiication interfaces. 

RS-422: a standard for serial data cammunJcaiion 
interfaces, difFeieni from the RS-23i standard in 
its eleclfical characLcrisiics and in its use of 
difTerenLial pairs for data signals. The serial ports 
on the Apple IIGS use RS-'iSZ devices modified so 
as lo be compatible with RS-232 devices. 

SCC: Abbreviation for Seriai Communications 

ControJier, a type of communicaiiorLS IC used in 
the Apple IICS. The SCC can run synchronous data 
transmission protocol and thus transmit data at 
faster rates than the AClA. 

screen holes: Locations In the text display buffer 
<texi Page 1) used for temporary storage either by 
I/O routines running in peripheral-card ROM or 
by firmware routines addiessed as if they were in 
card ROM. Text Page 1 occupies memory from 
SO-iOO to SC17FF; the screen holes are locations in 
that area that arc neither displayed nor modified 
by ihe display firmware. 

sector: See track. 



shadowing: The process whereby any changes 
made [o one part of the Apple IIGS memory are 
automaLJcally and simultaneously copied Into 
anolher pan. VChen .^hadcnp-'ing is on, ififDrmalion 

written lo bank SOO or SOI is automatically copied 
Into equivalent locations in bank -JeO or S'EL 
Likewise^ any change.'i tn bank SEO or SEl are 
immediately reflected in bank SOO or SOI. 

64k Apple II: Any standard Apple II that has at 
least 6'^K of RAM. This includes the Apple lie, the 
Apple ne, and an Apple 11 or Apple H Plus with 
A&K of RAM and the language card installed. 

6502: The microprocessor used in the Apple LL, 
the Apple Tl Plus, and eariy models of the 
Apple nc. Tine 6502 is a MOS device with S-bit data 
registers and 16-bit address registers. 

65C02: A CMOS veraion of the 6502, this is the 

microprocessor used in llie Apple lie and the 
enhanced Apple He. 

65C816; The microprocessor used in the 

Apple riGS The 65C316 i.'j a CMOS device with 16- 

bit data registers and 24-bit address registers. 

SmartPorlJ A set of firmware routines supporting 
multiple block devices connected to the 
Apple 1IG5 disk pan. See also extended 
SnaartFurt caJI and standard SmartFort cailJ. 

soft swrLtclu A locau'on in memory that produces 
^ specific eFPecl whenever its contents ace read or 
written. 

source fllej An ASCII Pie consisting of 
instructions written in a particular language, such 
as Pascal or assembly language. An assembler or a 
Compiler converts a source file into an object file. 

SSO AbbrevialEon for Super Serial Card, a 
peripheral card that enables an Apple II to 
communicate wiih serial devices. 
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Stact: A list in which entries are added Cpushcid) 
and removed Cpulted) at one end only Cthc ir>p of 
Ihe stack), causing Lhcm lo he removed in lasi-in, 
(irst-out (LIFO) Order The ^tscb usually Tefers to 
tbe paniculsf slack pointed to hy the 65C816 s 
smck register. 

Slack feglstcji A hardware regisEcr in the G*;c»lfi 
processor (iial toniains ibe address of the tap of 
the processor's suck. 

standard Apple 11: Any compucer in the Apple II 
family except the App3e HOS lliis includes the 
Apple 11^ ihe Apple II Plus, the Apple lie, and ihe 
Apple lie, 

standard SmartPort caU; A SmaciPort caU that 
allows data transfer lo or from anywhere in 
standard Apple IT memory, or the lowest 64K of 
Apple llCiS memory. Compire extended 
SmarCPort call. 

start up: To get ihe system running. See bool* 

Super Hi-Res: A high -resolution graphics display 
mode on Lhe Apple llGS, consisting of an array of 
pcilnts 320 wide by 200 high wiih 16 colors or 640 
wide by 200 high with l6 colors Cwith resirictJoris) 

synthesizer; A hardware device capable of 
creating sound digitally and converting it into an 
analog waveform that can he heard. 

system: dl^k: A disk that contains Lhe operating 
system and other sysiern software needed to run 

applications. 

ifysteoi software: TJie components of a 
computer system that support applicafion 
programs by managing system resources such a.i 
memory and t/O devices. 

tcrmlnaJ mode: The modf? of operation in which 
the Appk: llGS acts tike an intelligeiu terminal, 

text window; "Ihe portion of the Apple 11 screen 
that is reserved for text. At startup, Lhe firmware 
initializes the tniire display lo text. However. 
applications can restrict text lo any rectangular 
portion of lhe display. 
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toot See tool set. 

toolhoxi A cotleaion of built-in routines on the 
Apple ncs that programs can call to perform 
many commonly needed hmrtions. Functions 
within the toolbox are grntijxrd into tool sets. 

tool Bft A mroLip of reffltrd routines (usually in 
firmware) that perfr>rm necessary functions or 
pKJvidp programming convenience They aic 
available to appilicaiionN and sysiem software, The 
Memory Manager^ the System Loader, and 
QuickDra'w II are icjol seLs. 

track.' One of a series of concentric o'rdes that are 
magnetfcally drawn on the recording surface of a 
disk when the disk is formatted. Tracks are further 
divided into sectors. 

vector: A location containing a value that, when 
added lo a base addrT^:!i5 value, provides the 
address that is Lhe entry point of a. specific kind of 
routine. 

word: A group of bits that Is treated as a unit For 
[he Apple llGS, a word is 16 bits (2 bytes) long. 

■x flag; One of three Flag bits in the 650il6 
processor that programs use to control the 
processor's operating modes ]n natl-ve mode, 
rJie setting of the x flag determines whether the 
mdex registers are e or 1 6 bits wide. See also e flag 
and nt Hag. 

XONs A special character (value Si 5) used for 

controlling the transfer of data between two pieces 
of equipmeni. See also handshaking and XOFF. 

XOFF: A .spedal character (value 3 nj used for 
controllinR the transfer of data between two pteoss 
of etjuipment. When one piece of equipmeni 
receives an XOFF character from lhe other, it 
sinps transmitting characters until it receives an 
XON. See also handshaklag and XON. 

Kero page: 'llie first page (256 bytes) of memory 
m a ijlandard Apple IT computer Cor in the 
Apple IlGS when mnning a standard Apple U 
program). Because the hish-order byte of any 
address m this part of memory is a;ro. only a 
single byle is needed to specify a zero-page 
addres-S Cfimpare direct page. 
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ABORT 179 
Abort command IBS 
ABOETMGRV 265 
accumuliiiloj' 35 
iccumuEator mcHdc 62 
ADB mkirQcoiiiltoller. See 
Apple DeskTop Bus 
microcontro9ler 
addLtion 32-biL 
ADVA>fCE 2iO 
AMPERV 2^9 
apculrophe CO 'iO, 64 
Apple DcsJsTop Bus connector 8 
Apple DeskTop Bus input cLevices 

10 
Apple I^&kTop Bu£ microcontroller 
6, tS3, 185-156 

commands ]e8'195 

Slalus bylc 196 
Apple 3.5 disk drive 117, 133^ 135 

SmartPort calls 138- Ml 
APPLEII 237 
Apple lie 11 
Apple lie Plus 222 
Apple IIGS 

boot/scat! sei^uence 17 

detached keyboard 10 

SQ-column display 71 

flfmwace 2-6 

40-tolumn disf^^y 71 
" interrupts l6 

I/O 'expansion slots 1 1 

I/O pOi« 11 

memory addresses 21 

memory spact 9 

microprocessor 3-9 

Monitor. Ses system Monitor 

fffOgram operaliDn levels 4 

sound system 10 



112 

Smpa Hi-Res display 9-10 

lecrhnical manuals 216-221 

Toolbox 2, aifi. 310 
Apple IIGS Disk II 

fimiware 5 

I/O pon charactcrisLJcs 111 

S(na.i[Pori interactions 15^ 

support 109-112 
AppEcsoft BASIC 2, 43k 74, 87, 

112, 178 
Apple Bupet Serial Card (SBC) 82 
AppteTalk 3, B, 15, 17, S2. 9Q, 
173 

Inlerrupts ISO 
A register 13, 35 

changing GO 

system interrupt handler IBl 
arrow keys 72 

ASCI! 25, 26, 2% 51, 67, S6, 
123. 152 

fillers 3i 

nip 3^, 64 

inpur mode 30 

literal 30, 64 
as.«emMy language 

mouse routines 202, 211-213 

Pascal protocol 93-94 
al sign C@) 226 
AUXMOVE 260 



Back Arrow key 75 

laackgrou rwt printing 97-93 
bacfc^ilash CO 75 
Backspace key 70, 75 
BADBLOCK 156 
BADCMD 156 
BADCTL 156 
BADCTLPARM 156 



BADPCNT 156 

BADLTNIT 156 
bank 500 12. 15 

firmware entry poin^ 224-257 

page Px vectors 262-263 

page 3 routines 260-261 

page 3 A'caors 259 

ninning a program in 49, 65 
bank/addresa 21, 22, 26, 29, 32, 

64 
bank $E0 303-310 
bank JEl 303-310 

vtcters 264-255 
BASCALC 239 

BASIC 4a 51. 74, 75, 02. 83, 36, 
87, 9C, 112 

comniattd 43 

interface 93 

mouse programs 206-206 

mouse routine^ 203 
EASICIN 70-73 
BASIQNPUT 209 
BASICOUT 70, 73, 76-78, 80 

BASicounpui' 209 

Eatiery RAM 299, 30^ 

baud viLXc SS 

BD CMnmand 96, 97. 183 

BELL 233 

BHXl 239 

BELL 1.2 239 

BELL2 240 

DELLVECrOR 270 

BINITENTHY 209 

boot-fa jlurc screen 17 

btrcn/scan sequence 17 

BREAK 233 

Break (BRK) 36, 183 

BREAKVECTOn 270 

B register IB, 35 

BRK 179 
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DllXV 259 

BS 2^1 

ilufTcring Enibk 83 

BUSERR 156 

bus re-^idenLs 157 

button 1 status 201-205 



Catl sutement 20 

caret ("] 53, 55 

carriage rclum 59h 75^ 93 

CLAMPMOUSt- 209. 213 

Clear Modes command 189 

CLEARMOUSE 2m, 2\2 

CLEOLZ 79 

doch 306 

dock cdipi inSiemjpte 180 

Qose call 5, I3M32 

CLREOL 19, 243 

CLREOUi 243 

CLREOP 79, 242 

Cl.RSCR 79, 226 

CLKTOP 79. 227 

cold start 65, 112, 178, 2M 

colon C;3 28, 29. 40, 51, 52. 64 

color grpphics 10 

command chaFactier.s ff7 

communications mode 87 

fjrintt:r mf?idc 97 

Icrminail mode 91-92 
cofnnund packets, SmAnPon 159, 

166-167 
command sttlngs 87 
communicationi modt; 63 

command character B7 

cominands ^l-'O? 
Contlinue BASIC c?omm»ntl 43 
ConlfOl-A 64 
Control! 77 
Control A 77 
Cont.ntjl-] 77 
Con[rol-_ 77 
CbntroE'A 77 ' 
Control -A S7 
ConLrol-B 'tB, 65 
Contfol-C 43, 65 
Control call 129-13Q 



control characters 73, 7&-78 

suppressing 90 
Ccmttol-E 60. 77 
Conlro]-F 77 
Control-C 77 

Contiol-H 77 
Contiol-I 97 
Conlrol-J 77 

Coniiol-L 77 

Conifol-M 77 

Com to; -N 77 

Conliol-O 77 

Control-P 40, 64 

Control Panel 3. 40, 75, 82, 63, 

86, 90, 93r S7, 110, J12, 117. 

130, 299-307 
Conliol-Q 77 
Conirol-R 66, 77 
Cofitrol-Resel 43, 46, 112 
CootroUS 77 
CraitioUT 64 
Cbntrot-U 77 
Control-V 77 
Conlrol-W 77, 37 
Conirol-X 5a, 75, 77, 2'i7 
ConLfol-V 47. 65, 77 
COP 36, 179 
COPMGRV 265 

copy-protection engineer CCPK 
tools 144-14^ 
COPYRIGHT 209 
COLT 70, 71, 75, 7&, 79, 249 
COUTl 64, 70, 74, 76-80, 249 
COUT iubfouiine 39 
COUrZ 249 
CPE Coepy-pfottctJon tngimcef) 

tools 144'145 
CR 242 

C router 18, 35 
CEOUT 7*>, 24a 
CROLTl 247 
C3COUT1 64, 70, 76-78 
CTliLWHCTOH 274 
CUP DATE 269 
cursor 7 1 
changing 41, 64 
cortifol 72 
keys 10 



dau bank register 13, 16, 35, 92 

changing 61 

sj.'siem interrupt handler 181 
data bulTer poinier 126-127 
data byte encoding table 164 
data cafrtcr detect 0>CD) 84 

data formal ^8 

data set ready VUblC IM-S:?, 9^ 

cUu termirtal ready (DTR) 84-^5, 

95 
diile 

Chang ln{$ 64 

dLsplaying 40, 63 
DBR regis-ter 11, 13. 35 
DCfl (device control blocks 123. 

130 
DCD Cdana ca/rler deiecO S4 
debugging 48 
DECBUSYPIjCt 270 
decimal numbers, convening 41. 

65 
Delete hey 75 
delta 199 
Desk Manager ISO 
device control block tDCB) 123, 

130 
device mapping 117-119 
DEVSPEC 156 
DIAGMOTJSF. 209 
diagno^bc routines 3 
DIG 256 

Digital awrilUiofChipCDOC) 10 
direct page 12, 15 
direct-page register 13 
direct tegLsler. system Interrupt 

handler l&l 
Disable Device SKQ comniund 19S 
disassembler 55^56 
erodes 293-29S 

Disk i: firmware 5 

DISKSW 156 

DISPATCH 1 264 

DISPATCH 2 264 

dispatch address 1 15 

display 302 

division, 32 bit 42 

DOC CDtgiiil QscillaioT Chip) 10 

ck?l];^r sign ($) 54 
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DOS 70, 110 


Esc-CtH«rol-iQ 73 


GhlLNO 247 




DOS 3,3 AS 


Fsr D 73 


GliTUsJl 247 




Downlead H3 


Eic E 73 


GlilLNZ 246 




D register 1 1, 35 


Esc 8 73 


GeiModeBiUi 95, lOO 




chanfjing 6o 


Esc F 73 


GETNUW 256 




DiSR Cdaia &ei read/J e'i-3'5, 95 


Fac 4 73 


GetOutnuffcr 97, 9S, 101 




DTR Cdau Lcrmin»l ready) 84-85, 


Esc 1 73 


GeiFurtSut 104 




35 


Esc J 73 


GetSCC 101 




DuoDisk 110 


Esc K 73 


Get Version Number command 






Flsc M 73 


192 




i 


Evcnl Manager 75, lfi3 


GUI chip 163. 136. 199 




Examine instruciioin 37 


GO 252 




EABORT 177, 363 


exclamalion poinl C!) 52 


Go command 36, 49 




HBRKIRQ 263 


Ekccule H£ 


graphics display modes 10 




echo 91 




graphics tablets 10 




IlCOP 177, 263 








T-D commsnd 91 


F 






PP. eammand 91 


FD commind 9Q 


M 




c riag 37 


FDIO 2A% 


hand-shaking R-i-8% 




Elect 138, 142 


FiU Memory command 59 


protocol 89 




emu|4ikin nicxJc 9, l'(, 37-39, 56, 


filter mask, changing 63 


IIFADR 344 




120 


firmwaie. See also specific 


hfxaclecimai 21. 25, 26, 32. 53, 




aiccumulator IS 


type 


115. ii6 


1 


changing 62 


cnlry points 224-257 


maih 42 




code 15 


ID bytes 222-223 


numbers, conViCning 41, 65 




5[ack 13 


C/O rauttncs Il-l6, 79 


HUNE 79, 226 




EMULSl'ACK 13 


Hag- modification commands 39 


IIOMF 79, 242 




Enable Device SRQ command 194 


flags S, 12. 14, 16, 35-3*i 


HOMEMOUSE 209, 213 




enable line formauing B9 


examining and changing 36^38 


hoolc Lab]e M5 




ENMl 263 


restoring 66 






Ensoniq chip InLerrupts 190 


nashing tejct 78 


1 




environment 8, 36 


flip ASCII 30, 64 


1 




flrmwife rouiincs ll-lfi 


riuih c^immand 6, leo 


IDkOUTTNE 250 




resenifig 66 


Flush Device Buffer command 195 


imniediaL€ mode 5'fi-57 




f-e«c>r1ng 14 


Flushing ucue IDZ 


INCRlISYFirj 270 




syslcm inlerrupt handler 181 


Push Keyboard Buffer command 


ind^H mode:, changing 6;^ ' 




equal sign (=) 37 


IBB 


INtT 236 1 




ERESET 263 


FlushOutQueue 102 


Inilcall 130 i 




error todies, SmaitPort 156 


Formal 5, 129, 139, H7 


IMTMOUSE 203, 2« 




error siAtus rcgisier 95 


free space 508, 3 if) 


IN PORT 251 




Esc A 73 




input bulTer 46, 75, 91 




Esc e 73 


G 


input links, redirecting 64 




escape codes 72, 73 


Input routines 71-75 




Escape key 72 


GBASCALC 227 


InQStaLus 96, 103 




escape mode ll, 72 


GetDTH 105 


INSnSI 2 225 




Esc B 75 


GET816LEN 230 


INSf)S2 229 




Esc C 73 


GcllnBulTer 101 


INSTDSP 230 




Esc-Canlrol'D 73 


GetlnLlnfo %, 105, 184 


Intcgc:r BASIC 43, 74 




Eac-Control-E 73 


GETLK 21, 71, 74-75, 79. 246 
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Inlegraled iJCoz Machine C^W chip 

5. 110-311 
intelligent devic<^ 5 
intermpt 15, l5. 95, 96-37, 171 

priorities 177-180 

proc^slng 101'IS2; 

vcciors 177 
interrupii handler 16 

bulli-ln 172-174 

firmware 6, 169-184 
Interrupt Rtquesi (IRQ) line 17 L 
INTMCRV 264 
Inverse ccmniand S9i 6i 
inverse test 78 
iDVGESc video 39, 71 
lOERROR i^& 
yo links 70 
T/O port 5 1 14 
lORTS 254 
TRQ 180 
IRQAPTALK 266 
IPQDSKAGC 26a 
IRQ-EXT 369 
[RQ. FLUSH 269 
iRg.KBU 26b 
IRQ. MICRO 269 
[HQMOL'SE 267 
[RQ.IEEC 26? 
IRQ.On-lEH 2^9 
IRQQTR 26S 
IRQ- RESPONSE 268 
IRQ.SCAN 257 
IRQ-SERIAL 266 
IRQ.iiOUND 267 
IRQ.SRQ ZSe 
IRQ.VBL 267 
IKQLOC 2S9 
niQV|£cr|- 177 
IWM (Iniegraied Woz Machine) chip 

5h iio-in 



JMP instaiciioii 47, 50, G5, 66, 
H^ 

Joystick 10 

JSL See jump la jubrDUtlnc long 

JSR. See jump LO subfo-titinc 
)ump [a subrauiitiic Q5]i') 12, 14, 
47, 49, 49, 50, IH 



jump to subrcjutint long (JSL) 12, 

14. 50, 96, 152 



KUDWAIT 238 
ke^boafd 10, 40. 43, 7t, 72 
Input bulTcrins 75 

interrjpts 160 
language codes 190 
Keyboard command 40 
KEVIN 70, 71-72, 79, 245 
K fegislei 35 



language card l6 

area ilO 

bank 35, 56, 63 
language options 305 
last-opened tocation 25, 2d 
less-Lhan character M 31, 34 
LF 242 
line feed 83 

auTomaiic 90 

masking 91 
line length 89 
"LIST 250 
Listen S 

list knstruclioti 53, 55, 66 
literal ASCII 30. &4 
Local-area network. Sae 
AppkTalk 

M 

rrachsnc-langyage programs 48-50 
machine registers 12 
machine sale 36 

changing 6l 
mailbox registers 1^ 
mark table 144-145 
MasJtirkg Enable 83 
Mega 11 chip 306 
memory 9 

changing 28-31, 64 

comparlnB data J3 

moving dau 31-32 

searching for bytes 34 



memory dump 27 
memory locaLions 

changing 23-30 

displaying 53 

examining 26-27 

text window BO 
MEmory Manager 9, 15, 30S, 310 
memory range 

display 27 

flLElng 34 

termcnatlng 59 
m flag 37 
microprocessor, See specific 

mlnl-assemibler 5l-55i 74 

instruction formats 54-55 

opcodes 293- 29a 
mcKlem Communications 84 
mod£:m pon 301 
MON 255 

Monitor. J^ee system Monitor 
Monitor command 49 
iMonilor ftrmware 4 
MON^ 255 
MONZ2 255 
MONZ4 256 
mouse 

interrupts 190. 183 

position clamps 201 

pasitiom dsTai 199-201 
mouse ilrmw^r?- 6, 197-213 

rralls 209 

using 202-205 
mouse programs, BASIC 206-206 
MOVE 250 

Move command ji-ja^ 45, 59 
M register 36 
MEGPOINTtR 275 
MSIOT 266 
multiplkraljon, 32'bil 42 
music 10 



N 

NABORT 177, 262 

Dative mode 9, 14, 56 

accumulator IE 

slack pointer ]3i 114, 15 
NBREAK 177, 262 
NCX5P 177. 262 
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next-chsngfj^blc location 25| 26 

MIRQ 177, 262 

NMI 177, 178, 259 

MNMl 177, 262 

NOOIUVE 15* 

NOINT 156 

NONFATAL ISS 

Norm?! commiind 39, 44, 63 

normal video 39 

NOWFirn 156 

nUniKfIc keypad 10 
NXTAl 244 
NXTA^ 244 
NXTCHAR 257 

Nicrcoi 227 



OFFLINE 156 
OLDBRK 233 

OLDISQ 233 
OLDEST 255 
opcodes 56-57, 293'Z9R 
Open call 5, 131 

□pLlom 3O4-305 
OPTMOCSn 209 
OUTPORT 252 
output links, redireciing &t 
output j'out[nes 7&-78 
OuiQStanis 96, lOi 

pakltes ID 

padty 89 

Pascal 48, 82, 86, 97, llO. 210 

Pascal 1,1 93 

Pattern Seaich command 34, 55 

PBR register 11, 35 

PCADJ 232 

period CO 26, 27 

ptctJrc cI'CmenL. See pixel 
Plnil 2C9. 210 
pucel 10 

PLOT 79, 225 

PLOTl 225 

plus sign C+) 71, 72 

Poll Device command 195 

P05M0USE 209, 211, 213 

PRAl 243 



PIIDL2 79, 2J1 
PKBLNJt 231 
PBDYTH 79, 248 
PKead 209, 210 
Pl^AO 235 
PREAD4 235 
P register 35 
PElEaR 253 
PKHEX 79, 248 
Printer command iO 
princcr moctd 83 

command character fi7 

CMrnmands 38-90 
printer port JOO 
PRNTAX 79, 230 
PKNTX 231 
PRNTYX 23Q 
processor staluS 

changing 6 1 

f eg liter 37 

system interrupt handjer 161 
ProDOS 43, 70, 110, 114. 115, 

130 
ProDOS 8 117, 220 
ProDOS 16 117, 220 
program, bank ccgistcr 17, 35 

sy«em inLerrupt handler 181 
program CDuntef ^\ 
program operation levels 4 
program register, changing 61 
prompt 74 
PROMPT 247 
prompt characier 

C-) 30, 26, 7^ 

CO 74 

CO 52.74 

c?:) 74 

PRO16MLI 274 

pseudoregistcrs &^ \6 
PStatus 209. 210 

PWREDUP 259 
PWriEe 209. 210 
PWRLT 234 



Q register 36 

Quagmire register I6, 36 



quarter- second timer interrupts 

lao 

qu&$iiDn mark (?) 74 

quit 306 

Quit Monitor commanid 43, 65 

i^uotfLiiort mark CO 34, 52 



RAM disk 17, 110, 114, 117, 234, 

303 
candom-number generjUor 72 
R command 9G 
RdAddr 146 
HDCHAR 246 
RDKEY 70, 71, 79, 244 
RDKEYl 245 
READ 253 

Read Address Field 1J9 
Read Available Character Sea 

command 193 
Read Available Keyboard LayouLs 

eoinrrtind 193 
ReadBlock call 5, 126 
Read call 132-133 
Read and Qc^f EfTOf Uyie 

command 192 
Read OS'nnguration Byles copnmand 

192 
RcadDaii 146 
Read Mktocontrotler Memory 

command 191i 
Read Modes Bylc command 191 
READMOUSt 183, 203, 209, 212 
read-only memory 20 
Receive Bytes command 194 
Recharge routine 97. 98 
REt3D&P 235 

rcgiflcr addresses^ moU-sc 200 
register -display command 22 
regisler-rrvodification commands 38 

registers e, 12-18. 35-36 

examining 60 

examining and chan^jing 36-36 

restoring 66 
RESERVEL> 156 
RESET 177, L7B, 234 
Reset ADD command 194 
RcseLlIook 140 



Index 



325 






Reset Keyboard M (croconiroHer 

com man d IBQ 
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65 
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SCROLL 24 J 

SCSi C^ma.tl Computet Syslt^rri 

Interface) 115 
Spe^k 139, 147 

Send ADB Keycode command 193 
Send coramand 97 
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SendRcsel 6 
serial-port firmware 5, 81-108 
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error handling 95 
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programm ing 92-94 
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SETINV 251 
SETKBD 25 1 
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SeiModeniis 95, 97, 100-101 
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SrrMOUSE 209, 211 
SETNORM 251 
SelOutEurfci 95, 97, 102 
SETPWRC 237 
St:lSCC 105 
SetSldes l4l 

scrrxT 236 

SETVBLCKl'S 209 

SET VIP 252 

SETWND 236 

SE1"WND2 237 

shadowing 308. 310 
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card 213 
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SLOOP 234 
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error codes 156 
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Issuing a call 120-121 
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pracltct format 163 
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138-141 

specific to LtniDisk 3.5 142-143 
SmartPort firmware 5, 17, 113-lfi5 
50FTCV 259 
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sound 303 
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S register 11, 35 

sitg leo 
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stack 15 

stack pointer 13-15, 35 

changing 61 
STAltrriME 209 
Status calls 121-125 
Status code error 122 
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STORADV 240 
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symbol table 291. 292 
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SYSDMGRV 265 
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